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