New-OrganizationSegment
Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.
Используйте командлет New-OrganizationSegment, чтобы создать сегменты организации для использования с политиками информационных барьеров в Портал соответствия требованиям Microsoft Purview. Сегменты организации не действуют до тех пор, пока не будут применены политики информационных барьеров.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
New-OrganizationSegment
[-Name] <String>
-UserGroupFilter <String>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Дополнительные сведения о фильтруемых атрибутах, которые можно использовать для определения сегментов, см. в разделе Атрибуты для политик информационных барьеров.
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"
В этом примере сегмент с именем HR определяется с помощью hr, значения в атрибуте Department.
Пример 2
New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"
В этом примере мы определили сегмент с именем NotSales, который включает всех, кто не находится в Sales. Часть командлета "-ne" относится к "не равно".
Пример 3
New-OrganizationSegment -Name "LocalFTE" -UserGroupFilter "Location -eq 'Local' -and Position -ne 'Temporary'"
В этом примере мы определили сегмент с именем LocalFTE, который включает пользователей, которые находятся локально и которые не указаны как временные.
Параметры
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false
. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Параметр Name указывает уникальное имя сегмента организации. Максимальная длина: 64 символа. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-UserGroupFilter
Параметр UserGroupFilter использует синтаксис фильтра OPATH для указания членов сегмента организации. Синтаксис : "Property -ComparisonOperator 'Value'"
(например, "MemberOf -eq 'Engineering Department'"
или "ExtensionAttribute1 -eq 'DayTrader'"
).
- Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например,
$true
,$false
или$null
), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные. - Property — это свойство с поддержкой фильтрации. Дополнительные сведения см. в разделе Атрибуты для политик информационных барьеров.
- ComparisonOperator — это оператор сравнения OPATH (например
-eq
, для равных и-like
для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators. - Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки (
'Value'
или'$Variable'
). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо'$User'
используйте'$($User -Replace "'","''")'
. Не заключайте целые числа или системные значения в кавычки (например, используйте500
,$true
,$false
, или$null
вместо них).
Подробные сведения о фильтрах OPATH в Exchange см. в разделе Дополнительные сведения о синтаксисе OPATH.
Используйте одно и то же свойство для всех сегментов и убедитесь, что сегменты не перекрываются (пользователю необходимо назначить только один сегмент).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |