Compartilhar via

az policy assignment

Gerenciar atribuições de política.

As atribuições de política são usadas para aplicar uma definição de política ou definição de conjunto de políticas a um determinado escopo de recurso.

Comandos

Nome Description Tipo Status
az policy assignment create

Crie uma atribuição de política.

 Core GA
az policy assignment delete

Excluir uma atribuição de política.

 Core GA
az policy assignment identity

Identidade gerenciada da atribuição de política.

 Core GA
az policy assignment identity assign

Atribuir uma identidade gerenciada.

 Core GA
az policy assignment identity remove

Remova a identidade gerenciada.

 Core GA
az policy assignment identity show

Recupere a identidade gerenciada.

 Core GA
az policy assignment list

Recupere todas as atribuições de política aplicáveis.

 Core GA
az policy assignment non-compliance-message

Mensagem de não conformidade usada pela atribuição de política.

 Core GA
az policy assignment non-compliance-message create

Crie uma mensagem de não conformidade.

 Core GA
az policy assignment non-compliance-message delete

Exclua uma mensagem de não conformidade.

 Core GA
az policy assignment non-compliance-message list

Recuperar mensagens de não conformidade.

 Core GA
az policy assignment non-compliance-message show

Recupere uma mensagem de não conformidade.

 Core GA
az policy assignment non-compliance-message update

Atualize uma mensagem de não conformidade.

 Core GA
az policy assignment show

Recuperar uma atribuição de política.

 Core GA
az policy assignment update

Atualize uma atribuição de política.

 Core GA

az policy assignment create

Editar

Crie uma atribuição de política.

Crie uma atribuição de política com o escopo e o nome fornecidos. As atribuições de política se aplicam a todos os recursos contidos em seu escopo. Por exemplo, quando você atribui uma política no escopo do grupo de recursos, essa política se aplica a todos os recursos do grupo.

az policy assignment create [--acquire-policy-token]
                            [--assign-identity --mi-system-assigned --system-assigned]
                            [--change-reference]
                            [--definition-version]
                            [--description]
                            [--display-name]
                            [--enforcement-mode {Default, DoNotEnforce}]
                            [--identity-scope]
                            [--location]
                            [--metadata]
                            [--mi-user-assigned --user-assigned]
                            [--name]
                            [--non-compliance-messages]
                            [--not-scopes]
                            [--overrides]
                            [--params]
                            [--policy]
                            [--policy-set-definition]
                            [--resource-group]
                            [--resource-selectors]
                            [--role]
                            [--scope]

Exemplos

Criar uma atribuição de política de recurso no escopo

az policy assignment create --scope "/providers/Microsoft.Management/managementGroups/{managementGroupName}" --policy {policyName} -p "{ 'allowedLocations': { 'value': [ 'australiaeast', 'eastus', 'japaneast' ] } }"

Criar uma atribuição de política de recurso e fornecer valores de parâmetro de regra

az Create a resource policy assignment and provide rule parameter values policy assignment create --policy {policyName} -p "{ 'allowedLocations': { 'value': [ 'australiaeast', 'eastus', 'japaneast' ] } }"

Criar uma atribuição de política de recurso com uma identidade atribuída pelo sistema

az policy assignment create --name myPolicy --policy {policyName} --mi-system-assigned --location eastus

Criar uma atribuição de política de recurso com uma identidade atribuída pelo sistema com acesso de função colaborador à assinatura

az policy assignment create --name myPolicy --policy {policyName} --mi-system-assigned --identity-scope /subscriptions/{subscriptionId} --role Contributor --location eastus

Criar uma atribuição de política de recurso com uma identidade atribuída pelo usuário

az policy assignment create --name myPolicy --policy {policyName} -g MyResourceGroup --mi-user-assigned myAssignedId --location westus

Criar uma atribuição de política de recurso com um modo de imposição

az policy assignment create --name myPolicy --policy {policyName} --enforcement-mode DoNotEnforce

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--assign-identity --mi-system-assigned --system-assigned

Define a identidade gerenciada atribuída pelo sistema.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--definition-version

A versão da política a ser atribuída.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--description

Descrição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--display-name

O nome de exibição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--enforcement-mode -e

O modo de imposição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valor padrão: Default
Valores aceitos: Default, DoNotEnforce
--identity-scope

Escopo que a identidade atribuída pelo sistema pode acessar.

--location -l

O local da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Parameters Arguments
--metadata

Os metadados de atribuição de política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--mi-user-assigned --user-assigned

Define a identidade gerenciada atribuída pelo usuário. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Identity Arguments
--name -n

O nome da atribuição de política.

--non-compliance-messages -m

As mensagens que descrevem por que um recurso não está em conformidade com a política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: non-compliance-message Arguments
--not-scopes

A atribuição de política excluiu escopos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--overrides

A substituição da política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--params -p

Os valores de parâmetro para a regra de política atribuída. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--policy

O nome ou a ID do recurso da definição de política ou definição do conjunto de políticas a ser atribuída.

--policy-set-definition -d

A definição de política ou definição de conjunto de políticas a ser atribuída.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-selectors

A lista de seletores de recursos para filtrar políticas por propriedades de recurso. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--role

Nome da função ou id que será atribuído à identidade gerenciada.

--scope

O escopo da atribuição de política.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az policy assignment delete

Editar

Excluir uma atribuição de política.

Exclua a atribuição de política com o nome e o escopo fornecidos.

az policy assignment delete --name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--resource-group]
                            [--scope]

Exemplos

Excluir uma atribuição de política no escopo

az policy assignment delete --scope subscriptions/{subscriptionId} --name EnforceNaming

Excluir uma atribuição de política

az policy assignment delete --name MyPolicyAssignment

Parâmetros Exigidos

--name -n

O nome da atribuição de política.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--scope

O escopo da atribuição de política.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az policy assignment list

Editar

Recupere todas as atribuições de política aplicáveis.

Recupere a lista de todas as atribuições de política aplicáveis à assinatura ou grupo de gerenciamento especificado.

az policy assignment list [--disable-scope-strict-match {0, 1, f, false, n, no, t, true, y, yes}]
                          [--expand]
                          [--filter]
                          [--management-group]
                          [--max-items]
                          [--next-token]
                          [--resource-group]
                          [--scope]

Exemplos

Listar atribuições de política que se aplicam a um grupo de recursos

az policy assignment list --resource-group TestResourceGroup --filter atScope() --expand LatestDefinitionVersion, EffectiveDefinitionVersion

Listar atribuições de política que se aplicam a um grupo de gerenciamento

az policy assignment list --management-group TestManagementGroup --filter atScope()

Listar atribuições de política que se aplicam a uma assinatura

az policy assignment list --filter atScope()

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--disable-scope-strict-match -d

Inclua atribuições de política herdadas de escopos pai ou em escopos filho.

Propriedade Valor
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--expand

Propriedades adicionais a serem incluídas na saída.

--filter

Filtrar os resultados da lista.

--management-group

O grupo de gerenciamento.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

O grupo de recursos.

--scope

Escopo no qual listar as atribuições de política aplicáveis. Se o escopo não for fornecido, o escopo será a assinatura implícita ou especificada.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az policy assignment show

Editar

Recuperar uma atribuição de política.

Recupere e mostre os detalhes de uma única atribuição de política com o nome e o escopo fornecidos.

az policy assignment show --name
                          [--expand]
                          [--resource-group]
                          [--scope]

Exemplos

Mostrar uma atribuição de política de recurso

az policy assignment show --name MyPolicyAssignment

Parâmetros Exigidos

--name -n

O nome da atribuição de política.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--expand

Propriedades adicionais a serem incluídas na saída.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--scope

O escopo da atribuição de política.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az policy assignment update

Editar

Atualize uma atribuição de política.

Atualize a atribuição de política com o nome e o escopo fornecidos aplicando os valores de propriedade fornecidos.

az policy assignment update --name
                            [--acquire-policy-token]
                            [--add]
                            [--change-reference]
                            [--definition-version]
                            [--description]
                            [--display-name]
                            [--enforcement-mode {Default, DoNotEnforce}]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--location]
                            [--metadata]
                            [--non-compliance-messages]
                            [--not-scopes]
                            [--overrides]
                            [--params]
                            [--policy]
                            [--policy-set-definition]
                            [--remove]
                            [--resource-group]
                            [--resource-selectors]
                            [--scope]
                            [--set]

Exemplos

Atualizar a descrição de uma atribuição de política de recurso

az policy assignment update --name myPolicy --description 'My policy description'

Parâmetros Exigidos

--name -n

O nome da atribuição de política.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--definition-version

A versão da política a ser atribuída.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--description

Descrição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--display-name

O nome de exibição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--enforcement-mode -e

O modo de imposição da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Default, DoNotEnforce
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--location -l

O local da atribuição de política.

Propriedade Valor
Grupo de parâmetros: Parameters Arguments
--metadata

Os metadados de atribuição de política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--non-compliance-messages -m

As mensagens que descrevem por que um recurso não está em conformidade com a política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: non-compliance-message Arguments
--not-scopes

A atribuição de política excluiu escopos. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--overrides

A substituição do valor da propriedade da política. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--params -p

Os valores de parâmetro para a regra de política atribuída. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--policy

O nome ou a ID do recurso da definição de política ou definição do conjunto de políticas a ser atribuída.

--policy-set-definition -d

A definição de política ou definição de conjunto de políticas a ser atribuída.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-selectors

A lista de seletores de recursos para filtrar políticas por propriedades de recurso. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--scope

O escopo da atribuição de política.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False