New-OrganizationSegment

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Security & Compliance

Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, confira PowerShell de Conformidade de Segurança&.

Use o cmdlet New-OrganizationSegment para criar segmentos de organização para uso com políticas de barreira de informações no portal de conformidade do Microsoft Purview. Os Segmentos de Organização não estão em vigor até que você aplique 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.

Syntax

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

Description

Para obter mais informações sobre os atributos filtrados que você pode usar para definir segmentos, consulte Atributos para políticas de barreira de informações.

Para usar esse cmdlet no PowerShell de Conformidade de Segurança & , 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 usando 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 todos que não estão em Vendas. A parte "-ne" do cmdlet refere-se a "não é igual".

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

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-UserGroupFilter

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'").

  • Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrada. 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 iguais 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. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

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

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance