New-AdaptiveScope

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-AdaptiveScope para criar escopos adaptáveis em sua organização. Escopos adaptáveis (ou escopos estáticos) são usados em políticas de retenção e políticas de rótulo de retenção.

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

Syntax

New-AdaptiveScope
   -Name <String>
   -FilterConditions <PswsHashtable>
   -LocationType <DynamicBoundaryLocationType>
   [-Comment <String>]
   [<CommonParameters>]

New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-Comment <String>]
   [<CommonParameters>]

Description

Para obter mais informações sobre as propriedades a serem usadas em escopos adaptáveis, consulte Informações de configuração para escopos adaptáveis.

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-AdaptiveScope -Name "Project X" -LocationType User -FilterConditions @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}

Este exemplo cria um escopo de consulta adaptável chamado Project X com os seguintes detalhes:

Escopo: Usuários
Consulta: "('País ou região' é igual a 'EUA' ou 'Canadá') e 'Department' é igual a 'Finance'".

Parâmetros

-Comment

O parâmetro Comment especifica um comentário opcional. Se você especificar um valor que contenha espaços, coloque-o entre aspas ("), por exemplo: “Está é uma observação de administrador”.

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

-FilterConditions

O parâmetro FilterConditions especifica as condições incluídas no limite dinâmico. A sintaxe e os valores válidos dependem do valor do parâmetro LocationType:

Usuário ou Grupo: atributos do Active Directory. Por exemplo, para a condição "('País ou região' é igual a 'EUA' ou 'Canadá') e 'Department' é igual a 'Finance'", use a seguinte sintaxe: @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
Site: propriedades personalizadas indexadas. Por exemplo, para a condição "'Cadeia de caracteres refinável 0' é igual a 'Recursos Humanos', use a seguinte sintaxe: @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

Você não pode usar esse parâmetro com o parâmetro RawQuery.

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

-LocationType

O parâmetro LocationType especifica o local em que o filtro de escopo adaptável é definido. Os valores válidos são:

User
Grupo (grupo do Microsoft 365)
Site

Type:	DynamicBoundaryLocationType
Accepted values:	Unknown, User, Group, Site
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

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

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

-RawQuery

O parâmetro RawQuery alterna o escopo para o modo de consulta avançado. Você usa a sintaxe de filtro OPATH para o modo de consulta avançado.

Você não pode usar esse parâmetro com o parâmetro FilterConditions.

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