Get-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 Get-RetentionPolicyTag per recuperare le impostazioni per un tag di conservazione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Get-RetentionPolicyTag
   [[-Identity] <RetentionPolicyTagIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Get-RetentionPolicyTag
   [-Mailbox <MailboxIdParameter>]
   [-OptionalInMailbox]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Descrizione

I tag di conservazione vengono utilizzati per applicare le impostazioni di conservazione dei messaggi alle cartelle o ai messaggi. Sono disponibili tre tipi di tag di conservazione:

• Tag dei criteri di conservazione
• Tag dei criteri predefiniti
• Tag personali

I tag di criteri di conservazione vengono applicati alle cartelle predefinite come Posta in arrivo e Elementi eliminati. I tag personali sono applicabili dall'utente a elementi e cartelle. I tag dei criteri predefiniti vengono applicati a tutti gli elementi ai quali non è applicato alcun tag dall'utente o che non sono stati ereditati dalla cartella nella quale si trovano. Il cmdlet Get-RetentionPolicyTag visualizza tutte le impostazioni per i tag specificati.

È 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

Get-RetentionPolicyTag

Con questo esempio vengono restituiti tutti i tag di conservazione.

Esempio 2

Get-RetentionPolicyTag -IncludeSystemTags

Con questo esempio vengono restituiti i tag di sistema oltre ai tag personali e predefiniti.

Esempio 3

Get-RetentionPolicyTag "Consolidated Messenger"

Con questo esempio vengono restituite le impostazioni per il tag Consolidated Messenger.

Esempio 4

Get-RetentionPolicyTag -Types Inbox,All | Format-Table Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize

In questo esempio vengono restituiti tutti i tag di conservazione di Posta in arrivo e Tutti i tipi e i risultati vengono reindirizzati al comando Format-Table per visualizzare le proprietà Name, Type, RetentionEnabled, AgeLimitForRetention e RetentionAction.

Parametri

-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

-Identity

Il parametro Identity consente di specificare il nome del tag.

Type:	RetentionPolicyTagIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSystemTags

Il parametro IncludeSystemTags consente di specificare se restituire qualsiasi tag di sistema. Con questa opzione non è necessario specificare alcun valore.

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

-Mailbox

Il parametro Mailbox restituisce i tag di conservazione assegnati ai criteri di conservazione applicati alla cassetta postale specificata. È 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)

Questo parametro restituisce solo i tag dei criteri predefiniti (DDT) e i tag personali; non restituisce tag dei criteri di conservazione.

Type:	MailboxIdParameter
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 restituire eventuali tag di conservazione opt-in assegnati alla cassetta postale specificata. Con questa opzione non è necessario specificare alcun valore.

Un tag di conservazione opt-in è un tag personale assegnato in modo esplicito alla cassetta postale con il comando Set-RetentionPolicyTag -Mailbox -OptionalInMailbox.

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

-Types

Il parametro Types consente di specificare il tipo di tag di conservazione da restituire. Tra i valori validi sono inclusi:

• Calendario
• Contatti
• DeletedItems
• Bozze
• Posta in arrivo
• JunkEmail
• Diario
• Note
• Outbox
• SentItems
• Attività
• Tutti
• RssSubscriptions
• ConversationHistory
• Personal

Il parametro accetta più valori separati da una virgola.

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

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.