Get-AzPolicySetDefinition

Obtiene las definiciones del conjunto de directivas.

Sintaxis

Name (valor predeterminado)

Get-AzPolicySetDefinition
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ManagementGroupName

Get-AzPolicySetDefinition
    -ManagementGroupName <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId

Get-AzPolicySetDefinition
    -SubscriptionId <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Builtin

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Builtin]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Custom

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Custom]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id

Get-AzPolicySetDefinition
    -Id <String>
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Description

El cmdlet Get-AzPolicySetDefinition obtiene una colección de definiciones de conjuntos de directivas o una definición de conjunto de directivas específica identificada por nombre o identificador.

Ejemplos

Ejemplo 1: Obtener todas las definiciones de conjuntos de directivas

Get-AzPolicySetDefinition

Este comando obtiene todas las definiciones del conjunto de directivas.

Ejemplo 2: Obtener la definición del conjunto de directivas de la suscripción actual por nombre

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Este comando obtiene la definición del conjunto de directivas denominada VMPolicySetDefinition de la suscripción predeterminada actual.

Ejemplo 3: Obtener la definición del conjunto de directivas de la suscripción por nombre

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

Este comando obtiene la definición de directiva denominada VMPolicySetDefinition de la suscripción con el identificador 3bf44b72-c631-427a-b8c8-53e2595398ca.

Ejemplo 4: Obtención de todas las definiciones de conjuntos de directivas personalizadas del grupo de administración

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Este comando obtiene todas las definiciones de conjuntos de directivas personalizadas del grupo de administración denominado Dept42.

Ejemplo 5: Obtener definiciones de conjuntos de directivas de una categoría determinada

Get-AzPolicySetDefinition | Where-Object {$_.metadata.category -eq "Virtual Machine"}

Este comando obtiene todas las definiciones del conjunto de directivas de la categoría "Máquina virtual".

Ejemplo 6: Obtención de la versión de definición del conjunto de directivas por identificador

Get-AzPolicySetDefinition -Id '/providers/Microsoft.Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87' -Version "1.1.1"

Este comando obtiene la versión 1.1.1 de la definición de directiva con el identificador /providers/Microsoft. Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

Ejemplo 7: Obtener todas las versiones de definición del conjunto de directivas de una definición de conjunto de directivas por nombre

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

Este comando obtiene todas las versiones de definición del conjunto de directivas de la definición del conjunto de directivas denominada VMPolicySetDefinition de la suscripción predeterminada actual.

Parámetros

-Builtin

Hace que el cmdlet devuelva solo definiciones de conjuntos de directivas integradas.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-Custom

Hace que el cmdlet devuelva solo definiciones de conjuntos de directivas personalizadas.

Propiedades de parámetro

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

Conjuntos de parámetros

Custom
Posición:Named
Obligatorio:True
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
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Expand

Lista separada por comas de propiedades adicionales que se incluirán en la respuesta. Los valores admitidos son "LatestDefinitionVersion, EffectiveDefinitionVersion".

Propiedades de parámetro

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

Conjuntos de parámetros

Name
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ManagementGroupName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
SubscriptionId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
Id
Posición:Named
Obligatorio: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 completo de la definición del conjunto de directivas que se va a obtener.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-ListVersion

Hace que el cmdlet devuelva solo versiones de definición de conjunto de directivas personalizadas.

Propiedades de parámetro

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

Conjuntos de parámetros

Name
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ManagementGroupName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
SubscriptionId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
Id
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ManagementGroupName

El nombre 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

ManagementGroupName
Posición:Named
Obligatorio: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 definición del conjunto de políticas que debes obtener.

Propiedades de parámetro

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

Conjuntos de parámetros

Name
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ManagementGroupName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
SubscriptionId
Posición:Named
Obligatorio:False
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:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

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

-Version

La versión de definición del conjunto de directivas en formato #.#.#

Propiedades de parámetro

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

Conjuntos de parámetros

Name
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ManagementGroupName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
SubscriptionId
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
Id
Posición:Named
Obligatorio: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

Salidas

IPolicySetDefinition