New-AdaptiveScope

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Security & Compliance

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet New-AdaptiveScope para crear ámbitos adaptables en su organización. Los ámbitos adaptables (o ámbitos estáticos) se usan en directivas de retención y directivas de etiquetas de retención.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

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 obtener más información sobre las propiedades que se usarán en ámbitos adaptables, consulte Información de configuración para ámbitos adaptables.

Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.

Ejemplos

Ejemplo 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"}

En este ejemplo se crea un ámbito de consulta adaptable denominado Project X con los detalles siguientes:

  • Ámbito: Usuarios
  • Consulta: "('País o región' es igual a 'EE. UU.' o 'Canadá') y 'Department' es igual a 'Finance'".

Parámetros

-Comment

El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".

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

-FilterConditions

El parámetro FilterConditions especifica las condiciones que se incluyen en el límite dinámico. La sintaxis y los valores válidos dependen del valor del parámetro LocationType:

  • Usuario o grupo: atributos de Active Directory. Por ejemplo, para la condición "('País o región' es igual a 'US' o 'Canadá') y 'Department' es igual a 'Finance'", use la sintaxis siguiente: @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
  • Sitio: propiedades personalizadas indizadas. Por ejemplo, para la condición "'Refinable string 0' es igual a 'Human Resources', use la sintaxis siguiente: @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

No puede usar este parámetro con el 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

El parámetro LocationType especifica la ubicación donde se define el filtro de ámbito adaptable. Los valores admitidos son:

  • User
  • Grupo (grupo de 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

El parámetro Name especifica un nombre único para el ámbito adaptable. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

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

-RawQuery

El parámetro RawQuery cambia el ámbito al modo de consulta avanzada. Use la sintaxis de filtro de OPATH para el modo de consulta avanzada.

No se puede usar este parámetro con el parámetro FilterConditions.

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