Set-OrganizationSegment
Этот командлет доступен только в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.
Используйте командлет Set-OrganizationSegment для изменения сегментов организации в Портал соответствия требованиям Microsoft Purview. Сегменты организации не действуют до тех пор, пока не будут применены политики информационных барьеров.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-OrganizationSegment
[-Identity] <PolicyIdParameter>
[-UserGroupFilter <String>]
[<CommonParameters>]
Описание
Сегменты определяются с помощью определенных атрибутов в Azure Active Directory.
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"
В этом примере для сегмента с идентификатором GUID c96e0837-c232-4a8a-841e-ef45787d8fcd мы обновили имя отдела на HRDept.
Параметры
-Identity
Параметр Identity указывает сегмент организации, который требуется изменить. Можно использовать любое значение, однозначно определяющее сегмент. Например:
- имя;
- различающееся имя (DN);
- GUID
Type: | PolicyIdParameter |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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
вместо них).
Используйте одно и то же свойство для всех сегментов и убедитесь, что сегменты не перекрываются (пользователю необходимо назначить только один сегмент).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |