Get-AzPolicyEnrollment

Módulo:
Az.Resources Module

Obtiene las inscripciones de directivas.

Sintaxis

ListBySubscriptionId (valor predeterminado) 

Get-AzPolicyEnrollment
    [-SubscriptionId <String[]>]
    [-IncludeDescendent]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ListByResourceGroupName 

Get-AzPolicyEnrollment
    -ResourceGroupName <String>
    [-SubscriptionId <String[]>]
    [-IncludeDescendent]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ListByScope 

Get-AzPolicyEnrollment
    -Scope <String>
    [-IncludeDescendent]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

GetByName 

Get-AzPolicyEnrollment
    -Name <String>
    -Scope <String>
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

GetById 

Get-AzPolicyEnrollment
    -Id <String>
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ListByManagementGroupId 

Get-AzPolicyEnrollment
    -ManagementGroupId <String>
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Description

El cmdlet Get-AzPolicyEnrollment obtiene una colección de inscripciones de directivas o una inscripción de directiva específica identificada por nombre o identificador.

Ejemplos

Ejemplo 1: Obtención de todas las inscripciones de directivas

Get-AzPolicyEnrollment

Este comando obtiene todas las inscripciones de directiva en la suscripción actual. Si necesita enumerar todas las inscripciones relacionadas con el ámbito especificado, incluidas las de ámbitos antecesor y las de ámbitos descendientes, pase el -IncludeDescendent parámetro .

Ejemplo 2: Obtención de una inscripción de directiva específica por nombre y ámbito

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyEnrollment -Name 'PolicyEnrollment07' -Scope $ResourceGroup.ResourceId

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup y lo almacena en la variable $ResourceGroup. El segundo comando obtiene la inscripción de directiva denominada PolicyEnrollment07 para el ámbito que identifica la propiedad ResourceId de $ResourceGroup.

Ejemplo 3: Obtención de todas las inscripciones de directiva en el ámbito del grupo de administración

$ManagementGroup = Get-AzManagementGroup -GroupName 'AManagementGroup'
Get-AzPolicyEnrollment -ManagementGroupId $ManagementGroup.Name

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 todas las inscripciones de directiva en el ámbito del grupo de administración identificado por la propiedad Name de $ManagementGroup.

Parámetros

-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

-Id

Identificador de recurso completo de la inscripción de directiva.

Propiedades de parámetro

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

Conjuntos de parámetros

GetById
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

-IncludeDescendent

Hace que la lista de inscripciones de directivas devueltas incluya todas las inscripciones de directivas relacionadas con el ámbito especificado, incluidas las de ámbitos antecesor y las de ámbitos descendientes. Si no se proporciona, solo se incluyen las inscripciones de directiva en y encima del ámbito especificado.

Propiedades de parámetro

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

Conjuntos de parámetros

ListBySubscriptionId
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
ListByResourceGroupName
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
ListByScope
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

-ManagementGroupId

Identificador del grupo de administración.

Propiedades de parámetro

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

Conjuntos de parámetros

ListByManagementGroupId
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

-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

GetByName
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

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

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

Conjuntos de parámetros

ListByResourceGroupName
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

-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

ListByScope
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
GetByName
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

-SubscriptionId

Identificador de la suscripción de destino.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:(Get-AzContext).Subscription.Id
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ListBySubscriptionId
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
ListByResourceGroupName
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

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

SwitchParameter

String

String

Salidas

IPolicyEnrollment