New-AdaptiveScope

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Security & Compliance

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

New-AdaptiveScope コマンドレットを使用して、組織内にアダプティブスコープを作成します。アダプティブスコープ (または静的スコープ) は、アイテム保持ポリシーと保持ラベルポリシーで使用されます。

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

構文

New-AdaptiveScope
   -Name <String>
   -FilterConditions <PswsHashtable>
   -LocationType <DynamicBoundaryLocationType>
   [-Comment <String>]
   [<CommonParameters>]

New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-Comment <String>]
   [<CommonParameters>]

説明

アダプティブスコープで使用するプロパティの詳細については、「アダプティブスコープの構成情報」を参照してください。

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

例

例 1

New-AdaptiveScope -Name "Project X" -LocationType User -FilterConditions @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}

この例では、次の詳細を含む Project X という名前のアダプティブクエリスコープを作成します。

スコープ: ユーザー
クエリ: "('Country or region' equals 'US' or 'Canada') and 'Department' equals 'Finance')。

パラメーター

-Comment

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

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

-FilterConditions

FilterConditions パラメーターは、動的境界に含まれる条件を指定します。有効な構文と値は、LocationType パラメーターの値によって異なります。

ユーザーまたはグループ: Active Directory 属性。たとえば、条件 "('Country or region' equals 'US' or 'Canada') と 'Department' が 'Finance' と等しい場合は、次の構文を使用します。 @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
サイト: インデックス付きカスタムプロパティ。たとえば、条件 "'Refinable string 0' が 'Human Resources' と等しい場合は、次の構文を使用します。 @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

RawQuery パラメーターでは、このパラメーターを使用できません。

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

-LocationType

LocationType パラメーターは、アダプティブスコープフィルターが定義されている場所を指定します。有効な値は次のとおりです。

User
グループ (Microsoft 365 グループ)
Site

Type:	DynamicBoundaryLocationType
Accepted values:	Unknown, User, Group, Site
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

Name パラメーターは、アダプティブスコープの一意の名前を指定します。最大の長さは 64 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

-RawQuery

RawQuery パラメーターは、スコープを高度なクエリモードに切り替えます。高度なクエリモードには OPATH フィルター構文を使用します。

FilterConditions パラメーターでは、このパラメーターを使用できません。

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

次の方法で共有