Get-RetentionPolicyTag

  • Riferimento
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.