Update-AzPolicyEnrollment

Modulo:

Az.Resources Module

Questa operazione aggiorna una registrazione dei criteri con le proprietà appena fornite.

Sintassi

UpdateByNameAndScope (Impostazione predefinita)

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

UpdateByInputObject

Update-AzPolicyEnrollment
    -InputObject <IPolicyEnrollment>
    [-Description <String>]
    [-DisplayName <String>]
    [-AssignmentScopeValidation <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-Metadata <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

UpdateById

Update-AzPolicyEnrollment
    -Id <String>
    [-Description <String>]
    [-DisplayName <String>]
    [-AssignmentScopeValidation <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-Metadata <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Descrizione

Il cmdlet Update-AzPolicyEnrollment aggiorna una registrazione dei criteri con le proprietà appena fornite.

Eventuali proprietà non specificate verranno mantenute dalla registrazione esistente.

Esempio

Esempio 1: Aggiornare il nome visualizzato

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId
Update-AzPolicyEnrollment -Id $PolicyEnrollment.Id -DisplayName 'Enrollment for VM location policy'

Il primo comando ottiene un gruppo di risorse denominato ResourceGroup11 usando il cmdlet Get-AzResourceGroup. Il comando archivia l'oggetto nella variabile $ResourceGroup. Il secondo comando ottiene la registrazione dei criteri denominata PolicyEnrollment07 usando il cmdlet Get-AzPolicyEnrollment. Il comando archivia l'oggetto nella variabile $PolicyEnrollment. Il comando finale aggiorna il nome visualizzato nella registrazione dei criteri identificata dalla proprietà Id di $PolicyEnrollment.

Esempio 2: Aggiornare tramite pipeline

$PolicyEnrollment = Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope "/subscriptions/$((Get-AzContext).Subscription.Id)"
$PolicyEnrollment.DisplayName = 'Updated VM Enrollment'
$PolicyEnrollment | Update-AzPolicyEnrollment

Il primo comando ottiene la registrazione dei criteri denominata PolicyEnrollment07 usando il cmdlet Get-AzPolicyEnrollment e lo archivia nella variabile $PolicyEnrollment. Il secondo comando imposta un nuovo nome visualizzato nell'oggetto $PolicyEnrollment. Il comando finale invia tramite pipe l'oggetto modificato per Update-AzPolicyEnrollment per rendere persistente la modifica.

Esempio 3: Aggiornare il selettore di risorse

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyEnrollment -Name 'VirtualMachinePolicyEnrollment' -Scope $ResourceGroup.ResourceId -ResourceSelector $ResourceSelector

Il primo comando ottiene un gruppo di risorse denominato ResourceGroup11 usando il cmdlet Get-AzResourceGroup. Il secondo comando crea un oggetto selettore di risorse che limita la registrazione alle risorse in posizioni diverse da Stati Uniti orientali o Stati Uniti orientali 2 e lo archivia nella variabile $ResourceSelector. Il comando finale aggiorna la registrazione dei criteri denominata VirtualMachinePolicyEnrollment 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à:	True
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à:	True
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à:	True
Valore dagli argomenti rimanenti:	False

-Id

ID della registrazione dei criteri da aggiornare. Usare il formato '{scope}/providers/Microsoft. Authorization/policyEnrollments/{policyEnrollmentName}'.

Proprietà dei parametri

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

Set di parametri

UpdateById

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

-InputObject

Oggetto Policy Enrollment da aggiornare.

Proprietà dei parametri

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

Set di parametri

UpdateByInputObject

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	True
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à:	True
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

UpdateByNameAndScope

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
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à:	True
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à:	True
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

UpdateByNameAndScope

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	True
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.

Input

IPolicyEnrollment

IResourceSelector

String

String

Output

IPolicyEnrollment