New-AdaptiveScope
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.
Utilisez l’applet de commande New-AdaptiveScope pour créer des étendues adaptatives dans votre organization. Les étendues adaptatives (ou étendues statiques) sont utilisées dans les stratégies de rétention et les stratégies d’étiquette de rétention.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
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
Pour plus d’informations sur les propriétés à utiliser dans les étendues adaptatives, consultez Informations de configuration pour les étendues adaptatives.
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 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"}
Cet exemple crée une étendue de requête adaptative nommée Project X avec les détails suivants :
- Étendue : Utilisateurs
- Requête : « ('Country or region' est égal à 'US' ou 'Canada') et 'Department' à 'Finance' ».
Paramètres
-AdministrativeUnit
Applicable : Sécurité & Conformité
{{ Fill AdministrativeUnit Description }}
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Comment
Applicable : Sécurité & Conformité
Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FilterConditions
Applicable : Sécurité & Conformité
Le paramètre FilterConditions spécifie les conditions incluses dans la limite dynamique. La syntaxe et les valeurs valides dépendent de la valeur du paramètre LocationType :
- Utilisateur ou groupe : attributs Active Directory. Par exemple, pour la condition « ('Pays ou région' est égal à 'US' ou 'Canada') et 'Department' à 'Finance' », utilisez la syntaxe suivante :
@{"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 : propriétés personnalisées indexées. Par exemple, pour la condition « 'Refinable string 0' équivaut à 'Human Resources', utilisez la syntaxe suivante :
@{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}
Vous ne pouvez pas utiliser ce paramètre avec le paramètre RawQuery.
Propriétés du paramètre
| Type: | PswsHashtable |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Default
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LocationType
Applicable : Sécurité & Conformité
Le paramètre LocationType spécifie l’emplacement où le filtre d’étendue adaptative est défini. Les valeurs valides sont les suivantes :
- Utilisateur
- Groupe (groupe Microsoft 365)
- Site
Propriétés du paramètre
| Type: | DynamicBoundaryLocationType |
| Valeur par défaut: | None |
| Valeurs acceptées: | Unknown, User, Group, Site |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Sécurité & Conformité
Le paramètre Name spécifie un nom unique pour l’étendue adaptative. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RawQuery
Applicable : Sécurité & Conformité
Le paramètre RawQuery bascule l’étendue en mode de requête avancé. Vous utilisez la syntaxe de filtre OPATH pour le mode de requête avancé.
Vous ne pouvez pas utiliser ce paramètre avec le paramètre FilterConditions.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AdaptiveScopeRawQuery
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.