Get-RetentionCompliancePolicy
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊,請參閱 安全性與合規性 PowerShell。
使用 Get-RetentionCompliancePolicy 來檢視 Microsoft Purview 合規性入口網站 中的現有保留原則。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-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 屬性值的值將會不正確。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-ErrorPolicyOnly
ErrorPolicyOnly 參數會指定是否只顯示結果中有散發錯誤的原則。 您不需要使用此參數指定值。
類型: | SwitchParameter |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-ExcludeTeamsPolicy
ExcludeTeamsPolicy 參數會指定是否要從結果中排除 Teams 原則。 您不需要使用此參數指定值。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-Identity
Identity 參數會指定您想要檢視的保留原則。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
類型: | PolicyIdParameter |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
適用於: | Security & Compliance |
-IncludeTestModeResults
IncludeTestModeResults 參數會指定是否要在原則詳細數據中包含測試模式的狀態。 您不需要使用此參數指定值。
如需模擬模式的詳細資訊,請參閲 了解模擬模式。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-RetentionRuleTypes
RetentionRuleTypes 參數會指定是否要傳回結果中 RetentionRuleTypes 屬性的值。 您不需要使用此參數指定值。
若要查看 RetentionRuleTypes 屬性,您必須使用管線將命令傳送至格式化 Cmdlet。 例如,Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes
。 如果您未使用 RetentionRuleTypes 參數,則值會顯示為空白。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |
-TeamsPolicyOnly
TeamsPolicyOnly 參數會指定是否只在結果中顯示 Teams 原則。 您不需要使用此參數指定值。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
適用於: | Security & Compliance |