Set-OrganizationSegment

Модуль:
Exchange PowerShell

Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.

Используйте командлет Set-OrganizationSegment для изменения сегментов организации в Портал соответствия требованиям Microsoft Purview. Организационные сегменты не вступают в силу, пока не будут применены политики информационных барьеров.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию) 

Set-OrganizationSegment
    [-Identity] <PolicyIdParameter>
    [-UserGroupFilter <String>]
    [<CommonParameters>]

Описание

Сегменты определяются с помощью определенных атрибутов в Microsoft Entra ID.

Чтобы использовать этот командлет в 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

Свойства параметров

Тип:PolicyIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-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 вместо них).

Используйте одно и то же свойство для всех сегментов и убедитесь, что сегменты не перекрываются (пользователь должен быть назначен только одному сегменту).

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.