New-AzPolicyEnrollment

Module:
Az.Resources Module

Crée une inscription de stratégie.

Syntaxe

Default (Par défaut) 

New-AzPolicyEnrollment
    -Name <String>
    -Scope <String>
    [-AssignmentScopeValidation <String>]
    [-Description <String>]
    [-DisplayName <String>]
    [-Metadata <String>]
    [-PolicyAssignmentId <String>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-ResourceSelector <IResourceSelector[]>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Description

Cette applet de commande New-AzPolicyEnrollment crée une inscription de stratégie avec l’étendue et le nom donnés. Les inscriptions aux politiques s’appliquent à toutes les ressources incluses dans leur champ d’application. Par exemple, lorsque vous créez une inscription de politique dans le cadre du groupe de ressources pour une attribution de politique au même niveau ou au-delà, l’inscription s’applique à toutes les ressources applicables du groupe de ressources.

Exemples

Exemple 1 : Inscription de stratégie au niveau de l’étendue de l’abonnement

$Subscription = Get-AzSubscription -SubscriptionName 'Subscription01'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -PolicyAssignmentId $Assignment.Id -Scope "/subscriptions/$($Subscription.Id)" -DisplayName 'VM Policy Enrollment'

La première commande obtient un abonnement nommé Subscription01 à l’aide de l’applet de commande Get-AzSubscription et le stocke dans la variable $Subscription. La deuxième commande obtient l’attribution de stratégie nommée VirtualMachinePolicyAssignment à l’aide de l’applet de commande Get-AzPolicyAssignment et la stocke dans la variable $Assignment. L’affectation doit avoir le paramètre EnforcementMode défini sur Inscrire. La commande finale crée l’inscription de stratégie pour l’affectation dans $Assignment au niveau de l’abonnement identifié par la chaîne d’étendue de l’abonnement.

Exemple 2 : Inscription de stratégie dans l’étendue du groupe d’administration

$ManagementGroup = Get-AzManagementGroup -GroupName 'AManagementGroup'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -PolicyAssignmentId $Assignment.Id -Scope $ManagementGroup.Id -Description 'Enrollment for VM policy at MG level'

La première commande obtient un groupe d’administration nommé AManagementGroup à l’aide de l’applet de commande Get-AzManagementGroup et le stocke dans la variable $ManagementGroup. La deuxième commande obtient l’attribution de stratégie nommée VirtualMachinePolicyAssignment à l’aide de l’applet de commande Get-AzPolicyAssignment et la stocke dans la variable $Assignment. L’affectation doit avoir le paramètre EnforcementMode défini sur Inscrire. La commande finale crée l’inscription de stratégie pour l’affectation dans $Assignment à l’étendue du groupe d’administration identifiée par la propriété ID de $ManagementGroup.

Exemple 3 : Inscription de stratégie avec sélecteur de ressources

$subscription = (Get-AzContext).Subscription
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; In = @("eastus", "eastus2")})}
New-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -Scope "/subscriptions/$($subscription.Id)" -PolicyAssignmentId $Assignment.Id -ResourceSelector $ResourceSelector

La première commande obtient l’abonnement auquel l’inscription sera créée, celle actuellement utilisée. La deuxième commande obtient l’attribution de stratégie nommée VirtualMachinePolicyAssignment à l’aide de l’applet de commande Get-AzPolicyAssignment et la stocke dans la variable $Assignment. La troisième commande crée un objet sélecteur de ressources qui limite l’inscription aux ressources situées dans usa Est ou USA Est 2 et les stocke dans la variable $ResourceSelector. La commande finale crée l’inscription de stratégie pour l’affectation dans $Assignment avec le sélecteur de ressources spécifié par $ResourceSelector.

Paramètres

-AssignmentScopeValidation

La possibilité de valider l’inscription se situe au niveau ou sous le champ d’application de l’affectation.

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

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Propriétés du paramètre

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzureRMContext, AzureCredential

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

-Description

La description de l’inscription à la police.

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

-DisplayName

Le nom affiché de l’inscription à la police.

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

-Metadata

Les métadonnées d’inscription aux politiques. Les métadonnées sont un objet ouvert et sont généralement une collection de paires clé-valeur.

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

-Name

Le nom de l’inscription à la police.

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
Alias:PolicyEnrollmentName

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

-PolicyAssignmentId

L’identifiant de la mission de politique qui est inscrite.

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

-PolicyDefinitionReferenceId

Lorsque l’attribution de stratégie associée concerne un jeu de stratégies (initiative), vous pouvez l’utiliser pour spécifier les ID de référence de définition de stratégie pour les définitions de stratégie dans l’ensemble de stratégies à inscrire. Ces identifiants correspondent à un sous-ensemble de policyDefinitions[*].policyDefinitionReferenceId dans la définition de l’ensemble de politiques. Lorsqu’elles sont spécifiées et non vides, seules les définitions de police référencées seront inscrites. Sinon, l’ensemble de stratégies est inscrit.

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

-ResourceSelector

Liste de sélecteurs de ressources pour filtrer les stratégies par propriétés de ressource.

Propriétés du paramètre

Type:

IResourceSelector[]

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

-Scope

Étendue de l’inscription de stratégie. Les étendues valides sont les suivantes : groupe d'administration (format : '/providers/Microsoft. Management/managementGroups/{managementGroup}'), abonnement (format : '/subscriptions/{subscriptionId}'), groupe de ressources (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'), ou ressource (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

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

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

IPolicyEnrollment