Get-CaseHoldPolicy

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Security & Compliance

このコマンドレットは、セキュリティ & コンプライアンス 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