Get-RetentionCompliancePolicy

參考

模組:: ExchangePowerShell

適用於:: Security & Compliance

此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。如需詳細資訊，請參閱安全 & 性合規性 PowerShell。

使用Get-RetentionCompliancePolicy來檢視Microsoft Purview 合規性入口網站中的現有保留原則。

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

Syntax

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

Description

此清單描述預設顯示的屬性。

名稱：原則的唯一名稱。
工作負載：目前，它會顯示 Exchange、SharePoint、OneDriveForBusiness、Skype、ModernGroup) (的所有工作負載，而且不會顯示套用原則的實際工作負載。
已啟用：值 True 表示原則已啟用。
模式：原則的目前作業模式。可能的值為測試 (測試內容，但不會強制執行任何規則) ，AuditAndNotify (當內容符合原則指定的條件時，不會強制執行規則，但通知電子郵件會傳送) 或強制 (原則的所有層面都會啟用並強制執行) 。

若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。

範例

範例 1

Get-RetentionCompliancePolicy

此範例會顯示組織中所有保留原則的摘要資訊。

範例 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

此範例會顯示名為「法規 123 合規性」之原則的詳細資訊，包括 DistributionStatus 和 *Location 屬性的正確值。

參數

-DistributionDetail

DistributionDetail 參數傳回 DistributionResults 屬性中詳細的原則散發資訊。您不需要使用此參數指定值。

如果您未使用此參數，DistributionStatus 和 *Location 屬性值的值將會不正確。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ErrorPolicyOnly

ErrorPolicyOnly 參數會指定是否只顯示結果中有散發錯誤的原則。您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExcludeTeamsPolicy

ExcludeTeamsPolicy 參數會指定是否要從結果中排除 Teams 原則。您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Identity

Identity 參數會指定您想要檢視的保留原則。您可以使用唯一識別原則的任何值。例如：

名稱
辨別名稱 (DN)
GUID

Type:	PolicyIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-IncludeTestModeResults

IncludeTestModeResults 參數會指定是否要在原則詳細資料中包含測試模式的狀態。您不需要使用此參數指定值。

如需模擬模式的詳細資訊，請參閲了解模擬模式。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionRuleTypes

RetentionRuleTypes 參數會指定是否要傳回結果中 RetentionRuleTypes 屬性的值。您不需要使用此參數指定值。

若要查看 RetentionRuleTypes 屬性，您必須使用管線將命令傳送至格式化 Cmdlet。例如，Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes。如果您未使用 RetentionRuleTypes 參數，則值會顯示為空白。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsPolicyOnly

TeamsPolicyOnly 參數會指定是否只在結果中顯示 Teams 原則。您不需要使用此參數指定值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance