Partilhar via

New-AdaptiveScope

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-AdaptiveScope para criar âmbitos ajustáveis na sua organização. Os âmbitos ajustáveis (ou âmbitos estáticos) são utilizados em políticas de retenção e políticas de etiquetas de retenção.

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

Sintaxe

Default 

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

AdaptiveScopeRawQuery 

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

Description

Para obter mais informações sobre as propriedades a utilizar em âmbitos adaptáveis, veja Informações de configuração para âmbitos adaptáveis.

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-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 âmbito de consulta adaptável denominado Project X com os seguintes detalhes:

  • Âmbito: Utilizadores
  • Consulta: "("País ou região" é igual a "EUA" ou "Canadá") e "Departamento" é igual a "Finanças".

Parâmetros

-AdministrativeUnit

Aplicável: Conformidade do & de Segurança

{{ Fill AdministrativeUnit Description }}

Propriedades do parâmetro

Tipo:Guid
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

-Comment

Aplicável: Conformidade do & de Segurança

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

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

-FilterConditions

Aplicável: Conformidade do & de Segurança

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:

  • Utilizador ou Grupo: atributos do Active Directory. Por exemplo, para a condição "("País ou região" é igual a "EUA" ou "Canadá") e "Departamento" é igual a "Finanças", utilize 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 refinável 0" é igual a "Recursos Humanos", utilize a seguinte sintaxe: @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

Não pode utilizar este parâmetro com o parâmetro RawQuery.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Default
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LocationType

Aplicável: Conformidade do & de Segurança

O parâmetro LocationType especifica a localização onde o filtro de âmbito adaptável está definido. Os valores válidos são:

  • Usuário
  • Grupo (grupo do Microsoft 365)
  • Site

Propriedades do parâmetro

Tipo:DynamicBoundaryLocationType
Valor padrão:None
Valores aceitos:Unknown, User, Group, Site
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

-Name

Aplicável: Conformidade do & de Segurança

O parâmetro Name especifica um nome exclusivo para o âmbito adaptável. 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:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RawQuery

Aplicável: Conformidade do & de Segurança

O parâmetro RawQuery muda o âmbito para o modo de consulta avançada. Utilize a sintaxe do filtro OPATH para o modo de consulta avançado.

Não pode utilizar este parâmetro com o parâmetro FilterConditions.

Propriedades do parâmetro

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

Conjuntos de parâmetros

AdaptiveScopeRawQuery
Cargo:Named
Obrigatório:True
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.