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 |