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」を参照してください。