Set-OrganizationSegment

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Security & Compliance

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