New-CaseHoldPolicy

モジュール:: ExchangePowerShell

適用対象:: Security & Compliance

このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。

New-CaseHoldPolicy コマンドレットを使用して、Microsoft Purview コンプライアンスポータルに新しいケースホールドポリシーを作成します。

注:

New-CaseHoldPolicy コマンドレットを使用してケース保持ポリシーが作成された後、New-CaseHoldRule コマンドレットを使用して、ケース保持ルールを作成し、ポリシーにルールを割り当てる必要があります。 ポリシーのルールを作成しない場合、保留は作成されません。また、コンテンツの場所は保留されません。

このコマンドレットを実行すると、organization間で完全同期が実行されます。これは重要な操作です。複数のポリシーを作成する必要がある場合は、ポリシーの配布が成功するまで待ってから、次のポリシーのコマンドレットをもう一度実行します。配布状態の詳細については、「 Get-CaseHoldPolicy」を参照してください。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-CaseHoldPolicy
   [-Name] <String>
   -Case <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

説明

セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。詳細については、「Microsoft Purview コンプライアンスセンターのアクセス許可」を参照してください。

例

例 1

New-CaseHoldPolicy -Name "Regulation 123 Compliance" -Case "123 Compliance Case" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

この例では、キティピーターセンとスコット中村のメールボックスに対して "規制 123 コンプライアンス" という名前のケースホールドポリシーを作成し、電子情報開示ケースの財務 SharePoint サイトとして "123 コンプライアンスケース" を作成します。

ポリシーを作成した後は、New-CaseHoldRule コマンドレットを使用してポリシーのルールを作成する必要があることに注意してください。

パラメーター

-Case

Case パラメーターは、ケース保持ポリシーと関連付ける電子情報開示ケースを指定します。次の値を使用して、電子情報開示ケースを識別できます。

名前
ID (GUID 値)。

これらの値は、コマンド Get-ComplianceCase | Format-Table -Auto Name,Status,Identity を実行して確認できます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Comment

Comment パラメーターで、オプションのコメントを指定します。スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Enabled

Enabled パラメーターは、ポリシーが有効であるか無効であるかを指定します。有効な値は次のとおりです。

$true: ポリシーを有効にします。これは既定の値です。
$true: ポリシーを有効にします。これが既定値です。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExchangeLocation

ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。

ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。
メールボックス。

メールボックスまたは配布グループを指定するには、次の値を使用します。

名前
SMTP アドレス。非アクティブなメールボックスを指定するには、アドレスの前にピリオド (.) を付けます。
ObjectId をMicrosoft Entraします。この値を見つけるには、Microsoft Graph PowerShell の Get-MgUser コマンドレットまたは Get-MgGroup コマンドレットを使用します。

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

メールボックスが指定されていない場合、どのメールボックスも保持されません。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

Name パラメーターは、ケース保持ポリシーの一意の名前を指定します。値にスペースが含まれている場合は、値を引用符で囲んでください。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PublicFolderLocation

PublicFolderLocation パラメーターは、ケース保持ポリシーにすべてのパブリックフォルダーを含めることを指定します。このパラメーターに値 All を使用します。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SharePointLocation

SharePointLocation パラメーターは、含める SharePoint サイトと OneDrive サイトを指定します。サイトの URL 値によってサイトを識別します。