Set-RetentionPolicyTag
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet Set-RetentionPolicyTag per modificare le proprietà di un tag di conservazione.
Per altre informazioni sui tag di conservazione, vedere Tag di conservazione e criteri di conservazione in Exchange Server.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-RetentionPolicyTag
[-Identity] <RetentionPolicyTagIdParameter>
[-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-JournalingEnabled <Boolean>]
[-LabelForJournaling <String>]
[-LegacyManagedFolder <ELCFolderIdParameter>]
[-LocalizedComment <MultiValuedProperty>]
[-LocalizedRetentionPolicyTagName <MultiValuedProperty>]
[-MessageClass <String>]
[-MessageFormatForJournaling <JournalingFormat>]
[-MustDisplayCommentEnabled <Boolean>]
[-Name <String>]
[-RetentionAction <RetentionAction>]
[-RetentionEnabled <Boolean>]
[-RetentionId <Guid>]
[-SystemTag <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-RetentionPolicyTag
-Mailbox <MailboxIdParameter>
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-LegacyManagedFolder <ELCFolderIdParameter>]
[-LocalizedComment <MultiValuedProperty>]
[-LocalizedRetentionPolicyTagName <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-Name <String>]
[-OptionalInMailbox <RetentionPolicyTagIdParameter[]>]
[-RetentionId <Guid>]
[-SystemTag <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
I tag di conservazione vengono utilizzati per applicare le impostazioni di conservazione dei messaggi alle cartelle e agli elementi di una cassetta postale.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Set-RetentionPolicyTag "AllUsers-DeletedItems" -Comment "Items in the Deleted Items folder will be automatically deleted in 120 days"In questo esempio viene modificato il commento per il tag dei criteri di conservazione AllUsers-DeletedItems.
Esempio 2
Set-RetentionPolicyTag -Mailbox "Terry Adams" -OptionalInMailbox "ProjectA","ProjectB"In questo esempio si rendono disponibili i tag di conservazione facoltativi per l'utente Mario Rossi utilizzando i parametri Mailbox e OptionalInMailbox.
Parametri
-AddressForJournaling
Questo parametro è disponibile solo in Exchange Server 2010.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | RecipientIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-AgeLimitForRetention
Il parametro AgeLimitForRetention consente di specificare la validità del mantenimento applicato a un elemento. Il limite della validità corrisponde al numero di giorni a partire dalla data di recapito dell'elemento o dalla data di creazione di un elemento in caso di mancato recapito. Se tale parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.
| Type: | EnhancedTimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Comment
Il parametro Comment consente di specificare un commento per il tag dei criteri di conservazione.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Usare questa opzione per nascondere la richiesta di conferma quando si usa il parametro RetentionId.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Il parametro di Identity consente di specificare il nome, il nome distinto (DN) o il GUID del tag dei criteri di conservazione da modificare.
| Type: | RetentionPolicyTagIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-JournalingEnabled
Questo parametro è disponibile solo in Exchange Server 2010.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-LabelForJournaling
Questo parametro è disponibile solo in Exchange Server 2010.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-LegacyManagedFolder
Il parametro LegacyManagedFolder consente di specificare il nome di una cartella gestita. Il tag di conservazione viene creato utilizzando le impostazioni di conservazione della cartella gestita e le impostazioni del suo contenuto gestito. È possibile utilizzare questo parametro per creare tag di conservazione basati su cartelle gestite esistenti in modo da eseguire la migrazione degli utenti dai criteri per cartelle gestite ai criteri di conservazione.
| Type: | ELCFolderIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LocalizedComment
Il parametro LocalizedComment consente di specificare il commento localizzato e la lingua per il tag dei criteri di conservazione. Questo commento viene visualizzato in Microsoft Outlook in base alle impostazioni locali dell'utente.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LocalizedRetentionPolicyTagName
Il parametro LocalizedRetentionPolicyTagName consente di specificare un nome localizzato per il tag dei criteri di conservazione. Questo nome viene visualizzato in Outlook in base alle impostazioni locali dell'utente.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Il parametro Mailbox consente di specificare una cassetta postale per l'assegnazione dei tag con consenso esplicito. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
È necessario utilizzare tale parametro con il parametro OptionalInMailbox.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MessageClass
Il parametro MessageClass consente di specificare il tipo di messaggio a cui si applica il tag. Se non specificato, il valore predefinito è impostato su *.
Fatta eccezione per un tag di criteri predefinito per voicemail, Exchange non supporta i tag di conservazione per diversi tipi di messaggi. Sono supportati solo i tag con MessageClass di * che si applicano a tutti i tipi di messaggio.
Per creare un tag di criteri predefinito per i messaggi della casella vocale, impostare il parametro MessageClass su voicemail e il parametro Type su All.
Un tag di criteri predefinito per i messaggi della casella vocale è valido solamente per i messaggi della casella vocale di messaggistica unificata di Microsoft Exchange (identificati dal valore PR_MESSAGE_CLASS della proprietà MAPI IPM.Note.Microsoft.Voicemail*).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MessageFormatForJournaling
Questo parametro è disponibile solo in Exchange Server 2010.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | JournalingFormat |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-MustDisplayCommentEnabled
Il parametro MustDisplayCommentEnabled consente di specificare se è possibile nascondere il commento. Il valore predefinito è $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Il parametro Name consente di specificare il nome dei tag dei criteri di conservazione.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OptionalInMailbox
Il parametro OptionalInMailbox viene usato con il parametro Mailbox per assegnare tag personali alla cassetta postale. È possibile usare questo parametro per rendere disponibile a un utente un tag personale non assegnato ai criteri di conservazione applicati alla cassetta postale specificata. È possibile specificare più tag personali separati da virgole.
| Type: | RetentionPolicyTagIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetentionAction
Il parametro RetentionAction specifica l'azione per i criteri di conservazione. I valori validi sono:
- DeleteAndAllowRecovery: elimina un messaggio e consente il ripristino dalla cartella Elementi ripristinabili.
- DeleteAndAllowRecovery: consente di eliminare un messaggio e di ripristinarlo dalla cartella Elementi recuperabili.
- MoveToArchive: sposta un messaggio nella cassetta postale di archiviazione dell'utente. Questa azione può essere utilizzata per i tag di conservazione di tipo All, Personal e RecoverableItems.
- PermanentlyDelete: elimina definitivamente un messaggio. Un messaggio che è stato eliminato in modo permanente non può essere recuperato utilizzando la cartella Elementi recuperabili. I messaggi eliminati in modo permanente non vengono restituiti in una ricerca di individuazione, a meno che per la cassetta postale non sia abilitato il blocco a causa di una controversia.
Le azioni MoveToDeletedItems e MoveToFolder sono disponibili, ma non funzionano. Queste azioni sono disponibili per gli aggiornamenti da Gestione record di messaggistica (MRM) 1.0 (cartelle gestite) a Gestione record di messaggistica 2.0 (criteri di conservazione). MRM 2.0 è stato introdotto in Exchange 2010 Service Pack 1 (SP1).
Se tale parametro non è presente e il parametro RetentionEnabled è impostato su $true, viene restituito un errore.
| Type: | RetentionAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetentionEnabled
Il parametro RetentionEnabled consente di specificare se il tag è abilitato. Se impostato su $false, il tag viene disabilitato e non viene eseguita alcuna azione di conservazione nei messaggi a cui è applicato il tag.
I messaggi con un tag disabilitato vengono ancora considerati come contrassegnati da tag, pertanto tutti i tag predefiniti del criterio compresi nel criterio di conservazione dell'utente non vengono applicati a tali messaggi.
Quando si imposta il parametro RetentionEnabled su $false, il periodo di conservazione del tag è indicato con Mai. Gli utenti possono applicare il tag agli elementi che non devono essere mai eliminati oppure spostati nell'archivio. L'abilitazione del tag in un secondo momento potrebbe causare l'eliminazione involontaria o l'archiviazione degli elementi. Per evitare questa situazione, se un criterio di conservazione è disabilitato temporaneamente, potrebbe essere consigliabile modificare il nome di tale tag in modo che gli utenti siano scoraggiati dall'usarlo, ad DISABLED_<Original Name>esempio .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RetentionId
Il parametro RetentionId specifica un ID tag alternativo per garantire che il tag di conservazione trovato negli elementi della cassetta postale contrassegnati in un'organizzazione di Exchange corrisponda al tag quando la cassetta postale viene spostata in un'altra organizzazione di Exchange, ad esempio in una distribuzione tra foreste o in una distribuzione cross-premise, quando una cassetta postale viene spostata da un server Exchange locale al cloud, o una cassetta postale basata sul cloud viene spostata in un server Exchange locale).
In genere, non è necessario specificare o modificare il parametro RetentionId per un tag di conservazione. Questo parametro viene popolato automaticamente quando si importano tag di conservazione in una distribuzione tra foreste o cross-premise.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SystemTag
Il parametro SystemTag consente di specificare se il tag dei criteri di conservazione viene creato per le funzionalità interne di Exchange.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.