Get-RetentionCompliancePolicy
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
請使用 Get-RetentionCompliancePolicy 查看Microsoft Purview 合規性入口網站中現有的保留政策。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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
此範例顯示名為「Regulation 123 Compliance」的政策詳細資訊，包括 DistributionStatus 與 *Location 屬性的準確數值。
參數
-DistributionDetail
適用：安全性 & 合規
DistributionDetail 參數傳回 DistributionResults 屬性中詳細的原則散發資訊。 您不需要使用此參數指定值。
如果你不使用這個開關，DistributionStatus 和 *Location 屬性的值將會不準確。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ErrorPolicyOnly
適用：安全性 & 合規
ErrorPolicyOnly 開關會指定是否只顯示結果中存在分布錯誤的政策。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcludeTeamsPolicy
適用：安全性 & 合規
ExcludeTeamsPolicy 開關會指定是否要從結果中排除 Teams 政策。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：安全性 & 合規
Identity 參數指定你想要查看的保留政策。 您可以使用唯一識別原則的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | PolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeTestModeResults
適用：安全性 & 合規
IncludeTestModeResults 開關會指定是否要在政策細節中包含測試模式的狀態。 您不需要使用此參數指定值。
如需模擬模式的詳細資訊，請參閲 了解模擬模式。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PriorityCleanup
適用：安全性 & 合規
{{ 填寫優先清理描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RetentionRuleTypes
適用：安全性 & 合規
RetentionRuleTypes 開關會指定是否要回傳結果中 RetentionRuleTypes 和 HasRules 屬性的值。 您不需要使用此參數指定值。
要看到 RetentionRuleTypes 屬性，你需要將該指令輸入格式化 cmdlet。 例如，Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes。 如果你不使用RetentionRuleTypes開關，RetentionRuleTypes的值會顯示為空白，而HasRules則顯示為False。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TeamsPolicyOnly
適用：安全性 & 合規
TeamsPolicyOnly 開關會指定是否只顯示 Teams 政策。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。