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 со следующими сведениями:

Область: пользователи
Запрос: "("Страна или регион" равно "США" или "Канада") и "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