Set-ComplianceSecurityFilter

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2016, Exchange Server 2019, Security & Compliance

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

Set-ComplianceSecurityFilter コマンドレットを使用して、Microsoft Purview コンプライアンスポータルのコンプライアンスセキュリティフィルターを変更します。

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

構文

Set-ComplianceSecurityFilter
   -FilterName <String>
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-Description <String>]
   [-Filters <MultiValuedProperty>]
   [-Region <String>]
   [-Users <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

例

例 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.add("pilarp@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

この例では、フィルターに割り当てられている他のユーザー pilarp@contoso.com に影響を与えずに、Ottawa Users Filter という名前のコンプライアンスセキュリティフィルターにユーザーを追加します。

例 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.remove("annb@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

この例では、フィルターに割り当てられている他のユーザー annb@contoso.com に影響を与えずに、Ottawa Users Filter という名前のコンプライアンスセキュリティフィルターにユーザーを削除します。

パラメーター

-Action

Action パラメーターは、フィルターが適用される検索アクションの種類を指定します。このパラメーターの有効な値は All です。つまり、フィルターはすべての検索アクションに適用されます。

エクスポート: フィルターは、検索結果をエクスポートするとき、または電子情報開示 Premium で分析用に準備するときに適用されます。
プレビュー: 検索結果をプレビューするときにフィルターが適用されます。
消去: フィルターは、検索結果を消去するときに適用されます。項目の削除方法は、New-ComplianceSearchAction コマンドレットの PurgeType パラメーター値によって制御されます。既定値は SoftDelete です。つまり、削除されたアイテムは、削除されたアイテムの保持期間が切れるまでユーザーが回復できます。
検索: 検索の実行時にフィルターが適用されます。
Search: 検索を実行するときに、フィルターが適用されます。

Type:	ComplianceSecurityFilterActionType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, 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:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Description

Description パラメーターでは、コンプライアンスセキュリティフィルターの説明を指定します。最大の長さは 256 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

-FilterName

FilterName パラメーターは、変更するコンプライアンスセキュリティフィルターの名前を指定します。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

-Filters

Filters パラメーターは、コンプライアンスセキュリティフィルターの検索条件を指定します。次の 3 つの異なる種類のフィルターを作成できます。

メールボックスフィルター: 割り当てられているユーザーが検索できるメールボックスを指定します。有効な構文はです Mailbox_<MailboxPropertyName>。ここで <MailboxPropertyName> 、はメールボックスプロパティの値です。たとえば、"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" ユーザーは CustomAttribute10 プロパティの値 OttawaUsers を持つメールボックスのみを検索できます。サポートされているメールボックスのプロパティの一覧については、「 RecipientFilter パラメーターのフィルター可能なプロパティ」を参照してください。
メールボックスコンテンツフィルター: 割り当てられたユーザーが検索できるメールボックスコンテンツを指定します。有効な構文はです MailboxContent_<SearchablePropertyName>。ここで <SearchablePropertyName> 、コンプライアンス検索で指定できるキーワードクエリ言語 (KQL) プロパティを指定します。たとえば、ユーザーは、 "MailboxContent_Recipients -like 'contoso.com'" contoso.com ドメイン内の受信者に送信されたメッセージのみを検索できます。検索可能な電子メールプロパティの一覧については、「電子情報開示のキーワードクエリ」を参照してください。
サイトおよびサイトコンテンツフィルター: 作成できる Site_<SearchableSiteProperty> SharePoint Online フィルターとサイト関連フィルター OneDrive for Business 2 つあります (サイト関連のプロパティを指定します)。たとえば、"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'"ユーザーはサイトコレクション内のhttps://contoso.sharepoint.com/sites/doctorsコンテンツのみを検索できます。および SiteContent_<SearchableSiteProperty> (コンテンツ関連のプロパティを指定します)。たとえば、"SiteContent_FileExtension -eq 'docx'"ユーザーは Word 文書のみを検索できます)。検索可能なサイトプロパティの一覧については、「 SharePoint Server でのクロールされたプロパティと管理プロパティの概要」を参照してください。 [クエリ可能] 列で [はい] とマークされているプロパティを使用して、サイトまたはサイトのコンテンツフィルターを作成できます。

同じ種類の複数のフィルターを指定できます。たとえば、「 "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'" 」のように入力します。

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

-Region

Region パラメーターは、電子情報開示検索を実行する複数地域テナントのサテライトの場所を指定します。有効な値は次のとおりです。

APC: Asia-Pacific
AUS: オーストラリア
CAN: カナダ
EUR: ヨーロッパ、中東、アフリカ
FRA: フランス
GBR: イギリス
IND: インド
JPN: 日本
LAM: ラテンアメリカ
NAM: 北米

複数地域テナントでこのパラメーターを使用しない場合、電子情報開示検索は中央の場所で実行されます。

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

-Users

Users パラメーターは、このフィルターを検索に適用するユーザーを指定します。有効な値は次のとおりです。

1 人または複数のユーザー: エイリアスまたはメールアドレスでユーザーを識別します。複数の値をコンマで区切って指定できます。
値 All: フィルターをすべてのユーザーに割り当てます。この値は単体でのみ使用できます。
1 つまたは複数の役割グループ: 名前によって、役割グループを識別します。複数の値をコンマで区切って指定できます。

このパラメーターでは、配布グループを指定することはできません。

指定した値は、既存のエントリを上書きします。他の既存のエントリに影響を与えずにユーザーの追加または削除を行うには、例のセクションを参照してください。

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

-WhatIf

WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Security & Compliance

次の方法で共有