Get-RetentionPolicyTag

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。有些參數和設定可能是某一個環境所專屬。

使用 Get-RetentionPolicyTag 指令程式來擷取保留原則標記的設定。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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

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

Description

保留標記可用來將郵件保留設定套用到郵件或資料夾。保留標記有三種：

保留原則標記
預設原則標記
個人標記

保留原則標記套用到 [收件匣] 和 [刪除的郵件] 等預設資料夾。個人標記可供使用者標記項目和資料夾。預設原則標記套用到使用者未套用標記的所有項目，或不是從它們所在資料夾繼承的所有項目。 Get-RetentionPolicyTag 指令程式顯示指定標記的所有設定。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-RetentionPolicyTag

本範例會傳回所有的保留標記。

範例 2

Get-RetentionPolicyTag -IncludeSystemTags

本範例連同個人和預設標記一併傳回系統標記。

範例 3

Get-RetentionPolicyTag "Consolidated Messenger"

本範例傳回 Consolidated Messenger 標記的設定。

範例 4

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

本範例會傳回 [收件匣] 和 [所有類型] 的所有保留標記，並將結果傳送至 Format-Table 命令，以顯示 Name、Type、RetentionEnabled、AgeLimitForRetention 和 RetentionAction 屬性。

參數

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，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

Identity 參數會指定標記的名稱。

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

IncludeSystemTags 參數會指定是否傳回任何系統標記。您不需要使用此參數指定值。

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

Mailbox 參數會傳回指派給套用至指定信箱之保留原則的保留標記。您可以使用可唯一識別信箱的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
Domain\Username
電子郵件地址
GUID
LegacyExchangeDN
SamAccountName
使用者識別碼或使用者主要名稱 (UPN)

此參數只會 (DDPT) 和個人標記傳回預設原則標籤;它不會傳回保留原則標籤。

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

OptionalInMailbox 參數會與 Mailbox 參數搭配使用，以傳回指派給指定信箱的任何加入宣告保留標記。您不需要使用此參數指定值。

加入宣告保留標記是使用 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

Types 參數會指定要傳回的保留標記類型。有效值包括：

行事曆
聯絡人
DeletedItems
草稿
收件匣
垃圾郵件
日誌
注意事項
寄件匣
SentItems
工作
全部
RssSubscriptions
ConversationHistory
個人版

參數接受以逗號分隔的多個值。

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 types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。