Поделиться через


New-AdaptiveScope

Этот командлет доступен только в 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 со следующими сведениями:

  • Область: пользователи
  • Запрос: "("Страна или регион" равно "США" или "Канада") и "Department" равно "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. Например, для условия "("Страна или регион" равно "США" или "Канада") и "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"}
  • Сайт: индексированные настраиваемые свойства. Например, для условия "'Уточняемая строка 0" равна "Человеческие ресурсы", используйте следующий синтаксис: @{"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