Update-AzPolicyEnrollment

Módulo:
Az.Resources Module

Esta operación actualiza una inscripción de directiva con las propiedades recién proporcionadas.

Sintaxis

UpdateByNameAndScope (valor predeterminado) 

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>]

Description

El cmdlet Update-AzPolicyEnrollment actualiza una inscripción de directiva con las propiedades recién proporcionadas.

Las propiedades no proporcionadas se conservarán de la inscripción existente.

Ejemplos

Ejemplo 1: Actualizar el nombre para mostrar

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup. El comando almacena ese objeto en la variable $ResourceGroup. El segundo comando obtiene la inscripción de directiva denominada PolicyEnrollment07 mediante el cmdlet Get-AzPolicyEnrollment. El comando almacena ese objeto en la variable $PolicyEnrollment. El comando final actualiza el nombre para mostrar en la inscripción de directiva identificada por la propiedad Id de $PolicyEnrollment.

Ejemplo 2: Actualización a través de la canalización

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

El primer comando obtiene la inscripción de directiva denominada PolicyEnrollment07 mediante el cmdlet Get-AzPolicyEnrollment y la almacena en la variable $PolicyEnrollment. El segundo comando establece un nuevo nombre para mostrar en el objeto $PolicyEnrollment. El comando final canaliza el objeto modificado a Update-AzPolicyEnrollment para conservar el cambio.

Ejemplo 3: Actualización del selector de recursos

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup. El segundo comando crea un objeto selector de recursos que limita la inscripción a recursos en ubicaciones distintas de Este de EE. UU. o Este de EE. UU. 2 y la almacena en la variable $ResourceSelector. El comando final actualiza la inscripción de directiva denominada VirtualMachinePolicyEnrollment con el selector de recursos especificado por $ResourceSelector.

Parámetros

-AssignmentScopeValidation

La opción de validar la matrícula está en el ámbito de la tarea o dentro de él.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Propiedades de parámetro

Tipo:PSObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

La descripción de la inscripción en la póliza.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisplayName

El nombre de visualización de la inscripción en la póliza.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Id

Identificador de la inscripción de directiva que se va a actualizar. Use el formato '{scope}/providers/Microsoft. Authorization/policyEnrollments/{policyEnrollmentName}'.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ResourceId

Conjuntos de parámetros

UpdateById
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-InputObject

Objeto de inscripción de directiva que se va a actualizar.

Propiedades de parámetro

Tipo:IPolicyEnrollment
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UpdateByInputObject
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Metadata

Los metadatos de inscripción de políticas. Los metadatos son un objeto terminado abierto y normalmente es una colección de pares clave-valor.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

El nombre de la inscripción en la póliza.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PolicyEnrollmentName

Conjuntos de parámetros

UpdateByNameAndScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PolicyDefinitionReferenceId

Cuando la asignación de directiva asociada es para un conjunto de directivas (iniciativa), se puede usar para especificar los identificadores de referencia de definición de directiva para las definiciones de directiva del conjunto de directivas en el que se debe inscribir. Estos IDs corresponden a un subconjunto de policyDefinitions[*].policyDefinitionReferenceId en la definición del conjunto de políticas. Cuando se especifica y no está vacío, solo se inscribirán las definiciones de política referenciadas. De lo contrario, todo el conjunto de directivas está inscrito en.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResourceSelector

Lista del selector de recursos para filtrar las directivas por propiedades de recursos.

Propiedades de parámetro

Tipo:

IResourceSelector[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Scope

Ámbito de la inscripción de directivas. Los ámbitos válidos son: grupo de administración (formato: "/providers/Microsoft. Management/managementGroups/{managementGroup}'), suscripción (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}') o recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}')

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UpdateByNameAndScope
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

IPolicyEnrollment

IResourceSelector

String

String

Salidas

IPolicyEnrollment