New-AdaptiveScope

此 cmdlet 仅在安全性 & 合规性 PowerShell 中可用。 有关详细信息,请参阅 安全性 & 合规性 PowerShell

使用 New-AdaptiveScope cmdlet 在组织中创建自适应范围。 ) 的自适应范围 (或静态范围用于保留策略和保留标签策略。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

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

说明

有关在自适应范围中使用的属性的详细信息,请参阅 自适应范围的配置信息

若要在安全性 & 合规性 PowerShell 中使用此 cmdlet,需要分配权限。 有关详细信息,请参阅 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 的自适应查询范围:

  • 范围:用户
  • 查询:“ ('国家或地区'等于'美国'或'加拿大') ,'部门'等于'财务'”。

参数

-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 属性。 例如,对于条件“ (”国家或地区“等于”US“或”加拿大“) ,”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