New-AdaptiveScope
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 |