New-AdaptiveScope

Référence

Module:: ExchangePowerShell

S’applique à:: Security & Compliance

Cette applet de commande est disponible uniquement dans & Security Compliance PowerShell. Pour plus d’informations, consultez Conformité de la sécurité & PowerShell.

Utilisez l’applet de commande New-AdaptiveScope pour créer des étendues adaptatives dans votre organisation. 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.

Syntax

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

New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-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 utiliser cette applet de commande dans PowerShell de conformité de la sécurité & , 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

-Comment

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

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

-FilterConditions

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.

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

-LocationType

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

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

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 (").

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

-RawQuery

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.

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

Partager via