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 |