Partilhar via

New-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..

Utilize o cmdlet New-OrganizationSegment para criar segmentos de organização para utilização com políticas de barreira de informações no portal de conformidade do Microsoft Purview. Os Segmentos da Organização não estão em vigor até aplicar 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 (Padrão) 

New-OrganizationSegment
    [-Name] <String>
    -UserGroupFilter <String>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Description

Para obter mais informações sobre os atributos filtráveis que pode utilizar para definir segmentos, veja Atributos para políticas de barreira de informações.

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

New-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"

Neste exemplo, um segmento chamado RH é definido através de RH, um valor no atributo Departamento.

Exemplo 2

New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"

Neste exemplo, definimos um segmento chamado NotSales que inclui todas as pessoas que não estão em Vendas. A parte "-ne" do cmdlet refere-se a "não é igual a".

Exemplo 3

New-OrganizationSegment -Name "LocalFTE" -UserGroupFilter "Location -eq 'Local' -and Position -ne 'Temporary'"

Neste exemplo, definimos um segmento chamado LocalFTE que inclui pessoas localizadas localmente e cujas posições não estão listadas como Temporárias.

Parâmetros

-Confirm

Aplicável: Conformidade do & de Segurança

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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

-Name

Aplicável: Conformidade do & de Segurança

O parâmetro Nome especifica o nome exclusivo do segmento da organização. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-UserGroupFilter

Aplicável: Conformidade do & de Segurança

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

  • Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtráveis. Para obter mais informações, veja 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 cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators.
  • Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas ('Value' ou '$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de '$User', utilize '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize 500, $true, $falseou $null em alternativa).

Para obter informações detalhadas sobre filtros OPATH no Exchange, veja Informações adicionais sobre sintaxe OPATH.

Utilize a mesma propriedade para todos os segmentos e verifique se os segmentos não se sobrepõem (um utilizador tem de 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:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Conformidade do & de Segurança

A opção WhatIf não funciona no PowerShell de Segurança e Conformidade.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.