New-AdaptiveScope
Este cmdlet está disponible solo en Security & Compliance PowerShell. 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.
Sintaxis
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 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 Security & Compliance PowerShell, 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
-AdministrativeUnit
Aplicable: Cumplimiento de & de seguridad
{{ Fill AdministrativeUnit Description }}
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Comment
Aplicable: Cumplimiento de & de seguridad
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".
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FilterConditions
Aplicable: Cumplimiento de & de seguridad
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 se puede usar este parámetro con el parámetro RawQuery.
Propiedades del parámetro
| Tipo: | PswsHashtable |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Default
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LocationType
Aplicable: Cumplimiento de & de seguridad
El parámetro LocationType especifica la ubicación donde se define el filtro de ámbito adaptable. Los valores admitidos son:
- Usuario
- Grupo (grupo de Microsoft 365)
- Site
Propiedades del parámetro
| Tipo: | DynamicBoundaryLocationType |
| Valor predeterminado: | None |
| Valores aceptados: | Unknown, User, Group, Site |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Cumplimiento de & de seguridad
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 (").
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RawQuery
Aplicable: Cumplimiento de & de seguridad
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AdaptiveScopeRawQuery
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.