Get-CaseHoldPolicy
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
Get-CaseHoldPolicyを使用して、Microsoft Purview コンプライアンス ポータルの既存のケース ホールド ポリシーを表示します。 保留の適用方法と影響を受ける場所に関する関連情報を取得するには、DistributionDetail スイッチを含める必要があります。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-CaseHoldPolicy
[[-Identity] <PolicyIdParameter>]
[-Case <String>]
[-DistributionDetail]
[-IncludeBindings]
[-IncludeBindingsOnly]
[<CommonParameters>] 説明
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Get-CaseHoldPolicy -Case "Contoso Legal"次の例では、Contoso Legal という電子情報開示ケースに関連付けられているポリシーの詳しい情報を表示します。
例 2
Get-CaseHoldPolicy -Identity "Regulation 123 Compliance"この例では、「Regulation 123 Compliance」という名前のポリシーの詳しい情報を表示します。
パラメーター
-Case
Case パラメーターは、ポリシーに関連付けられている電子情報開示ケースを使って、表示するケース保持ポリシーを指定します。 次の値を使用して、電子情報開示ケースを識別できます。
- 名前
- ID (GUID 値)。
これらの値は、コマンド Get-ComplianceCase | Format-Table -Auto Name,Status,Identity を実行して確認できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-DistributionDetail
DistributionDetail スイッチは、ケース ホールド ポリシーに関する詳細なポリシー配布情報を返します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合、コマンドは現在の展開状態に関する情報を返しません。DistributionStatus プロパティは "Pending" としてのみ表示されます。
このスイッチの影響を受けるプロパティは次のとおりです。
- SharePointLocation
- ExchangeLocation
- PublicFolderLocation
- DistributionStatus
- DistributionResults
- LastStatusUpdateTime
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Identity パラメーターは、表示するケース保持ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | PolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeBindings
PARAMVALUE: SwitchParameter
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeBindingsOnly
{{ Fill IncludeBindingsOnly Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |