New-AzPolicyEnrollment

Crea una inscripción de directiva.

Sintaxis

Default (valor predeterminado)

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

Description

Este cmdlet New-AzPolicyEnrollment crea una inscripción de directiva con el ámbito y el nombre especificados. Las inscripciones en políticas se aplican a todos los recursos contenidos dentro de su alcance. Por ejemplo, cuando se crea una inscripción de política en el ámbito de grupo de recursos para una asignación de política al mismo nivel o superior, la inscripción se aplica a todos los recursos aplicables en el grupo de recursos.

Ejemplos

Ejemplo 1: Inscripción de directivas en el ámbito de la suscripción

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

El primer comando obtiene una suscripción denominada Subscription01 mediante el cmdlet Get-AzSubscription y la almacena en la variable $Subscription. El segundo comando obtiene la asignación de directiva denominada VirtualMachinePolicyAssignment mediante el cmdlet Get-AzPolicyAssignment y la almacena en la variable $Assignment. La asignación debe tener EnforcementMode establecido en Inscribir. El comando final crea la inscripción de directiva para la asignación en $Assignment en el nivel de la suscripción identificada por la cadena de ámbito de la suscripción.

Ejemplo 2: Inscripción de directivas en el ámbito del grupo de administración

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

El primer comando obtiene un grupo de administración denominado AManagementGroup mediante el cmdlet Get-AzManagementGroup y lo almacena en la variable $ManagementGroup. El segundo comando obtiene la asignación de directiva denominada VirtualMachinePolicyAssignment mediante el cmdlet Get-AzPolicyAssignment y la almacena en la variable $Assignment. La asignación debe tener EnforcementMode establecido en Inscribir. El comando final crea la inscripción de directiva para la asignación en $Assignment en el ámbito del grupo de administración identificado por la propiedad Id de $ManagementGroup.

Ejemplo 3: Inscripción de directivas con el selector de recursos

$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

El primer comando obtiene la suscripción en la que se creará la inscripción, la usada actualmente. El segundo comando obtiene la asignación de directiva denominada VirtualMachinePolicyAssignment mediante el cmdlet Get-AzPolicyAssignment y la almacena en la variable $Assignment. El tercer comando crea un objeto selector de recursos que limita la inscripción a los recursos ubicados en Este de EE. UU. o Este de EE. UU. 2 y los almacena en la variable $ResourceSelector. El comando final crea la inscripción de directiva para la asignación en $Assignment 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:False
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:False
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: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:False
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

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

-PolicyAssignmentId

El ID de la asignación de política que se está inscribiendo.

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:False
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:False
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:False
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

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
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.

Salidas

IPolicyEnrollment