New-CaseHoldPolicy

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Security & Compliance

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

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

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

以下の構文セクションのパラメーターセットの詳細については、「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 Online サイトを "123 コンプライアンスケース" と呼びます。

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

パラメーター

-Case

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

名前
ID (GUID 値)。

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Comment

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Enabled

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

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExchangeLocation

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

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

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

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

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

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Force

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-PublicFolderLocation

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SharePointLocation

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