Set-OrganizationSegment

Módulo:
Exchange PowerShell

Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..

Use o cmdlet Set-OrganizationSegment para modificar segmentos da organização no portal de conformidade do Microsoft Purview. Os segmentos da organização não estão em vigor até que você aplique as políticas de barreira de informações.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default) 

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

Description

Os segmentos são definidos usando determinados atributos no Microsoft Entra ID.

Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"

Neste exemplo, para o segmento que tem o GUID c96e0837-c232-4a8a-841e-ef45787d8fcd, atualizamos o nome do departamento para "HRDept".

Parâmetros

-Identity

Aplicável: Segurança & Conformidade

O parâmetro Identity especifica o segmento da organização que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente o segmento. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Propriedades do parâmetro

Tipo:PolicyIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserGroupFilter

Aplicável: Segurança & Conformidade

O parâmetro UserGroupFilter usa a sintaxe de filtro OPATH para especificar os membros do segmento de organização. A sintaxe é "Property -ComparisonOperator 'Value'" (por exemplo, "MemberOf -eq 'Engineering Department'" ou "ExtensionAttribute1 -eq 'DayTrader'").

  • Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $false, ou $null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrável. Para obter mais informações, consulte Atributos para políticas de barreira de informações.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo, -eq para igual e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
  • Valor é o valor da propriedade a ser pesquisado. Coloque os valores de texto e variáveis entre aspas simples ('Value' ou '$Variable'). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $false, ou $null em vez disso).

Use a mesma propriedade para todos os seus segmentos e verifique se os segmentos não se sobrepõem (um usuário deve ser atribuído a apenas um segmento).

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.