Partilhar via


az policy assignment

Gerencie atribuições de políticas.

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

Name Description Tipo Status
az policy assignment create

Crie uma atribuição de política.

Core disponibilidade geral
az policy assignment delete

Excluir uma atribuição de política.

Core disponibilidade geral
az policy assignment identity

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

Core disponibilidade geral
az policy assignment identity assign

Atribua uma identidade gerenciada.

Core disponibilidade geral
az policy assignment identity remove

Remova a identidade gerenciada.

Core disponibilidade geral
az policy assignment identity show

Recupere a identidade gerenciada.

Core disponibilidade geral
az policy assignment list

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

Core disponibilidade geral
az policy assignment non-compliance-message

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

Core disponibilidade geral
az policy assignment non-compliance-message create

Crie uma mensagem de não conformidade.

Core disponibilidade geral
az policy assignment non-compliance-message delete

Exclua uma mensagem de não conformidade.

Core disponibilidade geral
az policy assignment non-compliance-message list

Recupere mensagens de não conformidade.

Core disponibilidade geral
az policy assignment non-compliance-message show

Recupere uma mensagem de não conformidade.

Core disponibilidade geral
az policy assignment non-compliance-message update

Atualizar uma mensagem de não conformidade.

Core disponibilidade geral
az policy assignment show

Recuperar uma atribuição de política.

Core disponibilidade geral
az policy assignment update

Atualizar uma atribuição de política.

Core disponibilidade geral

az policy assignment create

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 aplicam-se 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 [--assign-identity --mi-system-assigned --system-assigned]
                            [--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 recursos 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 recursos 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 recursos com uma identidade atribuída ao sistema

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

Criar uma atribuição de política de recursos com uma identidade atribuída ao sistema com acesso à função de Colaborador à subscrição

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 recursos com uma identidade atribuída ao 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 recursos 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 tornar-se necessários para que o comando seja executado com êxito.

--assign-identity --mi-system-assigned --system-assigned

Define a identidade gerenciada atribuída ao sistema.

Propriedade Valor
Grupo de parâmetros: Identity 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 da política.

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

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

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

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Default value: Default
Valores aceites: Default, DoNotEnforce
--identity-scope

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

--location -l

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

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

Os metadados de atribuição de política. Suporta sintaxe taquigráfica, json-file 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 ao usuário. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

A substituição da política. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

O nome ou ID de recurso da definição de política ou definição de 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 atribuir.

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 recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

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

--scope

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az policy assignment delete

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
                            [--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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az policy assignment list

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

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

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 tornar-se necessários para que o comando seja executado com êxito.

--disable-scope-strict-match -d

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

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

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

--filter

Filtrar resultados da lista.

--management-group

O grupo de gestão.

--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 por onde começar a paginar. Este é o valor de 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 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az policy assignment show

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 recursos

az policy assignment show --name MyPolicyAssignment

Parâmetros Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az policy assignment update

Atualizar 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
                            [--add]
                            [--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 recursos

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

Parâmetros Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--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
--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 da política.

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

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

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

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

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

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

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

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

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

Os metadados de atribuição de política. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

O nome ou ID de recurso da definição de política ou definição de 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 atribuir.

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

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --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 recursos. Suporta sintaxe taquigráfica, json-file 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False