Get-AppRetentionCompliancePolicy
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Get-AppRetentionCompliancePolicy 來檢視應用程式保留合規性原則。 應用程式保留 & 標籤原則鎖定範圍和管理原則的新方式。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-AppRetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-RetentionRuleTypes]
[<CommonParameters>]
Description
*-AppRetentionCompliance* Cmdlet 用於具有調適性原則範圍的原則，以及涵蓋 Teams 聊天、Teams 頻道和私人頻道、Viva Engage 聊天和 Viva Engage 社群訊息的所有靜態原則。 最後，您將針對大部分的保留位置和原則類型使用這些 Cmdlet。 *-RetentionCompliance* Cmdlet 會繼續主要支援 Exchange 和 SharePoint 位置。 針對使用 *-AppRetentionCompliance* Cmdlet 建立的原則，您只能針對所有包含的工作負載設定包含或排除的範圍清單，這表示您可能需要為每個工作負載建立一個原則。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-AppRetentionCompliancePolicy | Format-Table Name,GUID
此範例會傳回所有應用程式保留合規性原則的摘要清單。
範例 1
Get-AppRetentionCompliancePolicy -Identity "Contoso Viva Engage"
此範例會傳回名為 Contoso Viva Engage 的應用程式保留合規性原則的詳細資訊。
參數
-DistributionDetail
適用對象：安全性 & 合規性
DistributionDetail 參數傳回 DistributionResults 屬性中詳細的原則散發資訊。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ErrorPolicyOnly
適用對象：安全性 & 合規性
{{ 填滿 ErrorPolicyOnly 描述 }}
參數屬性
| 類型: | 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: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-RetentionRuleTypes
適用對象：安全性 & 合規性
RetentionRuleTypes 參數會指定是否要在結果中傳回 RetentionRuleTypes 屬性的值。 您不需要使用此參數指定值。
若要查看 RetentionRuleTypes 屬性，您必須將命令透過管道傳送至格式設定 Cmdlet。 例如，Get-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes。 如果您未使用 RetentionRuleTypes 切換，此值會顯示空白。
參數屬性
| 類型: | 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。