Get-RetentionCompliancePolicy
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Get-RetentionCompliancePolicy を使用して、Microsoft Purview コンプライアンス ポータル内の既存のアイテム保持ポリシーを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>]
説明
この一覧では、既定で表示されるプロパティについて説明します。
- Name: ポリシーの一意の名前。
- ワークロード: 現時点では、すべてのワークロード (Exchange、SharePoint、OneDriveForBusiness、Skype、ModernGroup) が表示され、ポリシーが適用されている実際のワークロードは表示されません。
- Enabled: 値 True はポリシーが有効であることを意味します。
- Mode:ポリシーの現在の運用モード。 使用可能な値は、テスト (コンテンツはテストされますが、ルールは適用されません)、AuditAndNotify (コンテンツがポリシーで指定された条件と一致する場合、ルールは適用されませんが、通知メールは送信されます)、または強制 (ポリシーのすべての側面が有効および適用されます) です。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「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 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-ErrorPolicyOnly
ErrorPolicyOnly スイッチは、結果に分散エラーがあるポリシーのみを表示するかどうかを指定します。 このスイッチで値を指定する必要はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-ExcludeTeamsPolicy
ExcludeTeamsPolicy スイッチは、結果から Teams ポリシーを除外するかどうかを指定します。 このスイッチで値を指定する必要はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-Identity
Identity パラメーターは、表示するアイテム保持ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
型: | PolicyIdParameter |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-IncludeTestModeResults
IncludeTestModeResults スイッチは、ポリシーの詳細にテスト モードの状態を含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
シミュレーション モードの詳細については、「シミュレーション モードについて」を参照してください。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-RetentionRuleTypes
RetentionRuleTypes スイッチは、結果で RetentionRuleTypes プロパティの値を返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
RetentionRuleTypes プロパティを参照するには、このコマンドを書式設定コマンドレットにパイプします。 たとえば、「 Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes
」のように入力します。 RetentionRuleTypes スイッチを使用しない場合、値は空白になります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |
-TeamsPolicyOnly
TeamsPolicyOnly スイッチは、結果に Teams ポリシーのみを表示するかどうかを指定します。 このスイッチで値を指定する必要はありません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Security & Compliance |