Partilhar via


az policy attestation

Gerencie atestados de política de recursos.

Comandos

Name Description Tipo Status
az policy attestation create

Crie um atestado de política.

Core disponibilidade geral
az policy attestation delete

Exclua um atestado de política existente.

Core disponibilidade geral
az policy attestation list

Listar todos os atestados de um recurso.

Core disponibilidade geral
az policy attestation show

Obtenha um atestado de política.

Core disponibilidade geral
az policy attestation update

Atualize um atestado de política existente.

Core disponibilidade geral

az policy attestation create

Crie um atestado de política.

az policy attestation create --attestation-name --name
                             --policy-assignment --policy-assignment-id
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Exemplos

Criar um atestado no escopo do grupo de recursos para uma atribuição de política

az policy attestation create -g myRg -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Criar um atestado no escopo do grupo de recursos para uma atribuição de política usando a ID do recurso de atribuição de política

az policy attestation create -g myRg -n myAttestation \
  --policy-assignment "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa"

Criar um atestado no escopo da assinatura para uma atribuição de conjunto de políticas

az policy attestation create -n myAttestation \
  --policy-assignment eeb18edc813c42d0ad5a9eab \
  --definition-reference-id auditVMPolicyReference

Criar um atestado para um recurso específico usando a ID do recurso

az policy attestation create \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Criar um atestado no escopo do grupo de recursos usando todas as propriedades

az policy attestation create --attestation-name myAttestation -g myRg -a eeb18edc813c42d0ad5a9eab \
 --compliance-state Compliant --assessment-date 2023-01-01T08:29:18Z \
 --evidence source-uri=https://sampleuri.com description="Sample description for the sample uri" \
 --evidence source-uri=https://sampleuri2.com description="Sample description 2 for the sample uri 2" \
 --expires-on 2024-08-01T05:29:18Z --owner user@myOrg.com --metadata Location=NYC Dept=ACC \
 --definition-reference-id auditVMPolicyReference

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

--policy-assignment --policy-assignment-id -a

A ID do recurso da atribuição de política para a qual o atestado está definindo o estado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments

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.

--assessment-date

O momento em que as provas foram avaliadas.

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

Comentários que descrevem por que este atestado foi criado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--compliance-state

O estado de conformidade que deve ser definido no recurso.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Compliant, NonCompliant, Unknown
--definition-reference-id

A ID de referência da definição de política de uma definição de conjunto de políticas para a qual o atestado está definindo o estado. Se a atribuição de política atribuir uma definição de conjunto de políticas, o atestado poderá escolher uma definição dentro da definição de conjunto com essa propriedade ou omiti-la e definir o estado para toda a definição de conjunto.

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

As provas que sustentam o estado de conformidade estabelecido neste atestado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--expires-on

O tempo que o estado de conformidade deve expirar.

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

Metadados adicionais em pares key=value separados por espaço para um atestado. Isso substitui quaisquer metadados existentes para o atestado.

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

Namespace do provedor (Ex: Microsoft.Provider).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--owner

A pessoa responsável por definir o estado do recurso. Esse valor normalmente é uma ID de objeto do Azure Ative Directory.

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

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos de identificação de recursos relevantes.

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

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

Propriedade Valor
Grupo de parâmetros: Scope Arguments
--resource-type

Tipo de recurso (Ex: resourceTypeC).

Propriedade Valor
Grupo de parâmetros: Resource ID 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

az policy attestation delete

Exclua um atestado de política existente.

az policy attestation delete --attestation-name --name
                             [--namespace]
                             [--parent]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Exemplos

Excluir um atestado no escopo do grupo de recursos

az policy attestation delete -g myRg -n myAttestation

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

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.

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos de identificação de recursos relevantes.

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

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

Propriedade Valor
Grupo de parâmetros: Scope Arguments
--resource-type

Tipo de recurso (Ex: resourceTypeC).

Propriedade Valor
Grupo de parâmetros: Resource ID 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

az policy attestation list

Listar todos os atestados de um recurso.

az policy attestation list [--filter]
                           [--resource --resource-id]
                           [--resource-group]
                           [--top]

Exemplos

Listar todos os atestados de política no escopo da assinatura

az policy attestation list

Listar os dois principais atestados de política no escopo do grupo de recursos

az policy attestation list -g myRg --top 2

Listar todos os atestados que têm a ID de atribuição de política de myPolicyAssignment

az policy attestation list --filter "PolicyAssignmentId eq '/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5'"

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.

--filter

Expressão de filtro OData.

--resource --resource-id

ID do recurso.

--resource-group -g

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

--top

Número máximo de registos a devolver.

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 attestation show

Obtenha um atestado de política.

az policy attestation show --attestation-name --name
                           [--namespace]
                           [--parent]
                           [--resource --resource-id]
                           [--resource-group]
                           [--resource-type]

Exemplos

Mostre um atestado na assinatura.

az policy attestation show --attestation-name myAttestation

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

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.

--namespace

Namespace do provedor (Ex: Microsoft.Provider).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--parent

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--resource --resource-id

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos de identificação de recursos relevantes.

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

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

Propriedade Valor
Grupo de parâmetros: Scope Arguments
--resource-type

Tipo de recurso (Ex: resourceTypeC).

Propriedade Valor
Grupo de parâmetros: Resource ID 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

az policy attestation update

Atualize um atestado de política existente.

az policy attestation update --attestation-name --name
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--policy-assignment --policy-assignment-id]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Exemplos

Atualizar um atestado no escopo do recurso

az policy attestation update --attestation-name myAttestation \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  --comments "Adding comments for this attestation"

Parâmetros Obrigatórios

--attestation-name --name -n

O nome do atestado.

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.

--assessment-date

O momento em que as provas foram avaliadas.

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

Comentários que descrevem por que este atestado foi criado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--compliance-state

O estado de conformidade que deve ser definido no recurso.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Compliant, NonCompliant, Unknown
--definition-reference-id

A ID de referência da definição de política de uma definição de conjunto de políticas para a qual o atestado está definindo o estado. Se a atribuição de política atribuir uma definição de conjunto de políticas, o atestado poderá escolher uma definição dentro da definição de conjunto com essa propriedade ou omiti-la e definir o estado para toda a definição de conjunto.

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

As provas que sustentam o estado de conformidade estabelecido neste atestado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--expires-on

O tempo que o estado de conformidade deve expirar.

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

Metadados adicionais em pares key=value separados por espaço para um atestado. Isso substitui quaisquer metadados existentes para o atestado.

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

Namespace do provedor (Ex: Microsoft.Provider).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--owner

A pessoa responsável por definir o estado do recurso. Esse valor normalmente é uma ID de objeto do Azure Ative Directory.

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

O caminho pai (Ex: resourceTypeA/nameA/resourceTypeB/nameB).

Propriedade Valor
Grupo de parâmetros: Resource ID Arguments
--policy-assignment --policy-assignment-id -a

A ID do recurso da atribuição de política para a qual o atestado está definindo o estado.

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

ID do recurso ou nome do recurso. Se for dado um nome, forneça o grupo de recursos e outros argumentos de identificação de recursos relevantes.

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

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

Propriedade Valor
Grupo de parâmetros: Scope Arguments
--resource-type

Tipo de recurso (Ex: resourceTypeC).

Propriedade Valor
Grupo de parâmetros: Resource ID 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