New-AzPolicyEnrollment

Modulo:
Az.Resources Module

Crea una registrazione dei criteri.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

Questo cmdlet New-AzPolicyEnrollment crea una registrazione dei criteri con l'ambito e il nome specificati. Le iscrizioni alle politiche si applicano a tutte le risorse contenute nel loro ambito. Ad esempio, quando si crea una registrazione di policy nell'ambito del gruppo risorse per un'assegnazione di policy allo stesso livello o superiore, l'iscrizione si applica a tutte le risorse applicabili nel gruppo risorse.

Esempio

Esempio 1: Registrazione dei criteri nell'ambito della sottoscrizione

$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'

Il primo comando ottiene una sottoscrizione denominata Subscription01 usando il cmdlet Get-AzSubscription e la archivia nella variabile $Subscription. Il secondo comando ottiene l'assegnazione di criteri denominata VirtualMachinePolicyAssignment usando il cmdlet Get-AzPolicyAssignment e la archivia nella variabile $Assignment. L'assegnazione deve avere EnforcementMode impostato su Registra. Il comando finale crea la registrazione dei criteri per l'assegnazione in $Assignment a livello della sottoscrizione identificata dalla stringa di ambito della sottoscrizione.

Esempio 2: Registrazione dei criteri nell'ambito del gruppo di gestione

$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'

Il primo comando ottiene un gruppo di gestione denominato AManagementGroup usando il cmdlet Get-AzManagementGroup e lo archivia nella variabile $ManagementGroup. Il secondo comando ottiene l'assegnazione di criteri denominata VirtualMachinePolicyAssignment usando il cmdlet Get-AzPolicyAssignment e la archivia nella variabile $Assignment. L'assegnazione deve avere EnforcementMode impostato su Registra. Il comando finale crea la registrazione dei criteri per l'assegnazione in $Assignment nell'ambito del gruppo di gestione identificato dalla proprietà Id di $ManagementGroup.

Esempio 3: Registrazione dei criteri con selettore di risorse

$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

Il primo comando ottiene la sottoscrizione in cui verrà creata la registrazione, ovvero quella attualmente usata. Il secondo comando ottiene l'assegnazione di criteri denominata VirtualMachinePolicyAssignment usando il cmdlet Get-AzPolicyAssignment e la archivia nella variabile $Assignment. Il terzo comando crea un oggetto selettore di risorse che limita la registrazione alle risorse che si trovano negli Stati Uniti orientali o stati Uniti orientali 2 e lo archivia nella variabile $ResourceSelector. Il comando finale crea la registrazione dei criteri per l'assegnazione in $Assignment con il selettore di risorse specificato da $ResourceSelector.

Parametri

-AssignmentScopeValidation

L'opzione se validare l'iscrizione è all'interno o sotto l'ambito dell'assegnazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Proprietà dei parametri

Tipo:PSObject
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

La descrizione dell'iscrizione alla polizza.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisplayName

Il nome visualizzato dell'iscrizione alla polizza.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Metadata

I metadati di iscrizione alle politiche. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Il nome dell'iscrizione alla polizza.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PolicyEnrollmentName

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PolicyAssignmentId

L'ID dell'assegnazione politica che viene iscritta.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PolicyDefinitionReferenceId

Quando l'assegnazione di criteri associata è per un set di criteri (iniziativa), può essere usato per specificare gli ID di riferimento della definizione dei criteri per le definizioni dei criteri nel set di criteri a cui deve essere registrato. Questi ID corrispondono a un sottoinsieme di policyDefinitions[*].policyDefinitionReferenceId nella definizione del set di policy. Quando specificate e non vuote, verranno iscritte solo le definizioni di policy di riferimento. In caso contrario, l'intero set di criteri viene registrato su .

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceSelector

Elenco di selettore di risorse per filtrare i criteri in base alle proprietà delle risorse.

Proprietà dei parametri

Tipo:

IResourceSelector[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Scope

Ambito della registrazione dei criteri. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft. Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}'), gruppo di risorse (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}') o risorsa (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

IPolicyEnrollment