New-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 New-RetentionPolicyTag per creare 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
New-RetentionPolicyTag
[-Name] <String>
[-AddressForJournaling <RecipientIdParameter>]
[-AgeLimitForRetention <EnhancedTimeSpan>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-IsDefaultAutoGroupPolicyTag]
[-IsDefaultModeratedRecipientsPolicyTag]
[-JournalingEnabled <Boolean>]
[-LabelForJournaling <String>]
[-LocalizedComment <MultiValuedProperty>]
[-LocalizedRetentionPolicyTagName <MultiValuedProperty>]
[-MessageClass <String>]
[-MessageFormatForJournaling <JournalingFormat>]
[-MustDisplayCommentEnabled <Boolean>]
[-RetentionAction <RetentionAction>]
[-RetentionEnabled <Boolean>]
[-RetentionId <Guid>]
[-SystemTag <Boolean>]
[-Type <ElcFolderType>]
[-WhatIf]
[<CommonParameters>] New-RetentionPolicyTag
[-Name] <String>
[-ManagedFolderToUpgrade <ELCFolderIdParameter>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-IsDefaultAutoGroupPolicyTag]
[-IsDefaultModeratedRecipientsPolicyTag]
[-LocalizedComment <MultiValuedProperty>]
[-LocalizedRetentionPolicyTagName <MultiValuedProperty>]
[-MustDisplayCommentEnabled <Boolean>]
[-SystemTag <Boolean>]
[-Type <ElcFolderType>]
[-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.
I tag di conservazione supportano la visualizzazione del nome del tag e di un commento facoltativo nelle lingue localizzate. A questo scopo sono utilizzati i codici di lingua della classe CultureInfo.
È 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
New-RetentionPolicyTag "Finance-DeletedItems" -Type DeletedItems -RetentionEnabled $true -AgeLimitForRetention 30 -RetentionAction PermanentlyDeleteCon questo esempio viene creato il tag dei criteri di conservazione Finance-DeletedItems per la cartella Posta eliminata predefinita. Quando viene applicato a una cassetta postale come parte di un criterio di conservazione, il tag elimina in modo permanente gli elementi di tutti i tipi presenti nella cartella Posta eliminata da 30 giorni.
Esempio 2
New-RetentionPolicyTag "Finance-Default" -Type All -RetentionEnabled $true -AgeLimitForRetention 365 -RetentionAction PermanentlyDeleteCon questo esempio viene creato il tag dei criteri predefinito Finance-Default. Quando viene applicato a una cassetta postale come parte di un criterio di conservazione, il tag elimina in modo permanente tutti gli elementi privi di un tag di conservazione da 365 giorni. Gli elementi di una determinata classe di messaggi, ad esempio Voicemail, per cui esiste un tag predefinito (un tag di conservazione di tipo All) non sono interessate.
Esempio 3
New-RetentionPolicyTag "Business Critical" -Type Personal -Comment "Use this tag for all business critical mail" -RetentionEnabled $true -AgeLimitForRetention 2556 -RetentionAction PermanentlyDeleteCon questo esempio viene creato il tag di conservazione Business Critical di tipo Personal. Quando viene applicato agli elementi della cassetta postale come parte di un criterio di conservazione, gli elementi vengono eliminati in modo permanente in circa sette anni.
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.
| 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 |
-IsDefaultAutoGroupPolicyTag
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsDefaultModeratedRecipientsPolicyTag
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
-LocalizedComment
Il parametro LocalizedComment consente di specificare i commenti localizzati e le rispettive lingue. Quando l'impostazione della lingua dell'utente corrisponde a una lingua specificata per questo parametro, Microsoft Outlook e Outlook sul web visualizzare il commento localizzato corrispondente. I commenti vengono specificati come Codice lingua ISO:Commento, ad esempio LocalizedComment EN-US:"This is a localized comment in U.S. English".
| 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 i nomi dei tag localizzati e le rispettive lingue. Quando l'impostazione della lingua dell'utente corrisponde a una lingua specificata per questo parametro, Outlook e Outlook sul web visualizzare il nome del tag localizzato corrispondente. I nomi vengono specificati come Codice lingua ISO:Commento, ad esempio LocalizedRetentionPolicyTagName EN-US:"Business Critical".
| 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 |
-ManagedFolderToUpgrade
Questo parametro è disponibile solo in Exchange locale.
Il parametro ManagedFolderToUpgrade consente di specificare il nome di una cartella gestita da utilizzare come un modello per un tag 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 |
-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 tag con MessageClass di * e 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 del tag.
| Type: | String |
| Position: | 1 |
| 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 |
-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. È possibile usare questa azione 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 è disabilitato e non viene eseguita alcuna azione di conservazione sui messaggi con il tag.
I messaggi con un tag disabilitato vengono comunque considerati contrassegnati, quindi tutti i tag dello stesso tipo del tag disabilitato nei criteri 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 assicurarsi che il tag di conservazione trovato negli elementi della cassetta postale contrassegnati in una distribuzione locale corrisponda al tag quando la cassetta postale viene spostata nel cloud o che gli elementi della cassetta postale contrassegnati nel cloud corrispondano al tag quando la cassetta postale viene spostata in un server Exchange locale. Il parametro è utilizzato nelle distribuzioni tra sedi diverse. Non è necessario specificare questo parametro nelle distribuzioni esclusivamente locali.
| 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 specifica che il tag viene creato per la funzionalità interna 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 |
-Type
Il parametro Type consente di specificare il tipo di tag di conservazione in fase di creazione. Tra i valori validi sono inclusi:
- Tutti
- Archiviare
- Calendario
- Confusione: disponibile solo in Exchange Online.
- Contatti
- ConversationHistory
- DeletedItems
- Bozze
- Posta in arrivo
- Diario
- JunkEmail
- LegacyArchiveJournals
- ManagedCustomFolder
- Note
- Outbox
- Personal
- Elementi ripristinabili
- RssSubscriptions
- SentItems
- SyncIssues
- Attività
Per creare un tag di criteri predefinito, specificare il tipo All. Per i tag di tipo RecoverableItems, l'unica azione di conservazione valida è MoveToArchive.
| Type: | ElcFolderType |
| 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.