New-RetentionPolicyTag

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 PermanentlyDelete

Con 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 PermanentlyDelete

Con 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 PermanentlyDelete

Con 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.