Get-AzPolicyAssignment

Referencia

Módulo:: Az.Resources

Obtiene las asignaciones de directiva.

Syntax

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzPolicyAssignment obtiene todas las asignaciones de directiva o asignaciones concretas. Identifique una asignación de directiva para obtener por nombre y ámbito o por identificador.

Ejemplos

Ejemplo 1: Obtener todas las asignaciones de directiva

Get-AzPolicyAssignment

Este comando obtiene todas las asignaciones de directiva.

Ejemplo 2: Obtención de una asignación de directiva específica

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -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 asignación de directiva denominada PolicyAssignment07 para el ámbito que identifica la propiedad ResourceId de $ResourceGroup.

Ejemplo 3: Obtener todas las asignaciones de directiva asignadas a un grupo de administración

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

El primer comando especifica el identificador del grupo de administración que se va a consultar. El segundo comando obtiene todas las asignaciones de directiva asignadas al grupo de administración con el identificador "myManagementGroup".

Ejemplo 4: Obtener el ámbito, el identificador de definición del conjunto de directivas y el nombre para mostrar de todas las asignaciones de directiva con formato de lista

Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Este comando es útil cuando necesita encontrar la propiedad DisplayName fácil de lector de una asignación de Azure Policy.

Parámetros

-ApiVersion

Especifica la versión de la API del proveedor de recursos que se va a usar. Si no especifica una versión, este cmdlet usa la versión más reciente disponible.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Especifica el identificador de recurso completo para la asignación de directiva que obtiene este cmdlet.

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

Hace que la lista de asignaciones de directiva devueltas incluya todas las asignaciones relacionadas con el ámbito especificado, incluidas las de ámbitos antecesor y las de ámbitos descendientes.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Especifica el nombre de la asignación de directiva que obtiene este cmdlet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

Especifica el identificador de la definición de directiva de las asignaciones de directiva que obtiene este cmdlet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Especifica el ámbito en el que se aplica la directiva para la asignación que obtiene este cmdlet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

SwitchParameter

Salidas

PsPolicyAssignment