Get-AzPolicyDefinition
Obtém definições de política.
Sintaxe
Get-AzPolicyDefinition
[-Name <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-ManagementGroupName <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-SubscriptionId <Guid>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Builtin]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Custom]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Get-AzPolicyDefinition obtém uma coleção de definições de política ou uma definição de política específica identificada por nome ou ID.
Exemplos
Exemplo 1: Obter todas as definições de política
Get-AzPolicyDefinition
Esse comando obtém todas as definições de política.
Exemplo 2: Obter definição de política da assinatura atual por nome
Get-AzPolicyDefinition -Name 'VMPolicyDefinition'
Esse comando obtém a definição de política chamada VMPolicyDefinition da assinatura padrão atual.
Exemplo 3: Obter definição de política do grupo de gerenciamento por nome
Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'
Esse comando obtém a definição de política chamada VMPolicyDefinition do grupo de gerenciamento chamado Dept42.
Exemplo 4: Obter todas as definições de política internas da assinatura
Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin
Esse comando obtém todas as definições de política internas da assinatura com a ID 3bf44b72-c631-427a-b8c8-53e2595398ca.
Exemplo 5: Obter definições de política de uma determinada categoria
Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}
Este comando obtém todas as definições de política na categoria Tags.
Exemplo 6: Obter o nome de exibição, a descrição, o tipo de política e os metadados de todas as definições de política formatadas como uma lista
Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List
Esse comando é útil quando você precisa encontrar a propriedade DisplayName amigável de uma definição do Azure Policy. Você pode analisar a propriedade Metadata para descobrir o número de versão e a atribuição de categoria da definição de política.
Parâmetros
-ApiVersion
Especifica a versão da API do provedor de recursos a ser usada. Se você não especificar uma versão, esse cmdlet usará a versão mais recente disponível.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Builtin
Limita a lista de resultados apenas a definições de política internas.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Custom
Limita a lista de resultados apenas a definições de política personalizadas.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
Especifica a ID de recurso totalmente qualificada para a definição de política que esse cmdlet obtém.
Tipo: | String |
Aliases: | ResourceId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ManagementGroupName
O nome do grupo de gerenciamento das definições de política a serem obtidas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome da definição de política que esse cmdlet obtém.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SubscriptionId
A ID da assinatura da(s) definição(ões) de política a ser obtida(s).
Tipo: | Nullable<T>[Guid] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Entradas
Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]