Get-AppRetentionCompliancePolicy
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Get-AppRetentionCompliancePolicy を使用して、アプリ保持コンプライアンス ポリシーを表示します。 アプリの保持 & ラベル付けポリシーは、ポリシーの範囲指定と管理を行う新しい方法を対象としています。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-AppRetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-RetentionRuleTypes]
[<CommonParameters>]
説明
*-AppRetentionCompliance* コマンドレットは、適応型ポリシー スコープを持つポリシーと、Teams チャット、Teams チャネルとプライベート チャネル、Viva Engage チャット、および Viva Engage コミュニティ メッセージをカバーするすべての静的ポリシーに使用されます。 最終的には、ほとんどの保持場所とポリシーの種類に対してこれらのコマンドレットを使用します。 *-RetentionCompliance* コマンドレットは、引き続き主に Exchange と SharePoint の場所をサポートします。 *-AppRetentionCompliance* コマンドレットで作成されたポリシーの場合、含まれるすべてのワークロードについて、含めるスコープまたは除外するスコープの一覧のみを設定できます。これは、多くの場合、ワークロードごとに 1 つのポリシーを作成する必要があることを意味します。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「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 |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ErrorPolicyOnly
適用対象: セキュリティ & コンプライアンス
{{ Fill: ErrorPolicyOnly description }}
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: セキュリティ & コンプライアンス
Identity パラメーターには、表示するアプリ保持コンプライアンス ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | PolicyIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-RetentionRuleTypes
適用対象: セキュリティ & コンプライアンス
RetentionRuleTypes スイッチは、結果で RetentionRuleTypes プロパティの値を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
RetentionRuleTypes プロパティを参照するには、このコマンドを書式設定コマンドレットにパイプします。 たとえば、「 Get-AppRetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes 」のように入力します。 RetentionRuleTypes スイッチを使用しない場合、値は空白になります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。