az automation software-update-configuration

Note

Essa referência faz parte da extensão de automação da CLI do Azure (versão 2.55.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az automation software-update-configuration. Saiba mais sobre extensões.

Automação software-update-configuration.

Comandos

Nome	Description	Tipo	Status
az automation software-update-configuration create	Crie uma configuração de atualização de software de automação.	Extension	GA
az automation software-update-configuration delete	Exclua uma configuração de atualização de software de automação.	Extension	GA
az automation software-update-configuration list	Liste todas as configurações de atualização de software para a conta.	Extension	GA
az automation software-update-configuration machine-runs	O computador de configuração de atualização de software é executado.	Extension	GA
az automation software-update-configuration machine-runs list	Listar execuções de computador de configuração de atualização de software.	Extension	GA
az automation software-update-configuration machine-runs show	Obtenha uma única máquina de configuração de atualização de software executada por Id.	Extension	GA
az automation software-update-configuration runs	A configuração de atualização de software é executada.	Extension	GA
az automation software-update-configuration runs list	Lista de retorno de execuções de configuração de atualização de software.	Extension	GA
az automation software-update-configuration runs show	Obtenha uma única configuração de atualização de software executada por Id.	Extension	GA
az automation software-update-configuration show	Obtenha uma única configuração de atualização de software por nome.	Extension	GA

az automation software-update-configuration create

Crie uma configuração de atualização de software de automação.

az automation software-update-configuration create --automation-account-name
                                                   --configuration-name --name
                                                   --frequency
                                                   --interval
                                                   --operating-system {Linux, Windows}
                                                   --resource-group
                                                   [--azure-queries-locations]
                                                   [--azure-queries-scope]
                                                   [--azure-queries-tags]
                                                   [--azure-virtual-machines]
                                                   [--creation-time]
                                                   [--description]
                                                   [--duration]
                                                   [--excluded-kb-numbers]
                                                   [--expiry-time]
                                                   [--expiry-time-offset-minutes]
                                                   [--included-kb-numbers]
                                                   [--included-update-classifications]
                                                   [--is-enabled {false, true}]
                                                   [--last-modified-time]
                                                   [--next-run]
                                                   [--next-run-offset-minutes]
                                                   [--non-azure-computer-names]
                                                   [--non-azure-queries-function-alias]
                                                   [--non-azure-queries-workspace-id]
                                                   [--post-task-job-id]
                                                   [--post-task-source]
                                                   [--post-task-status]
                                                   [--pre-task-job-id]
                                                   [--pre-task-source]
                                                   [--pre-task-status]
                                                   [--reboot-setting]
                                                   [--start-time]
                                                   [--time-zone]

Exemplos

Criar uma configuração de atualização de software de automação

az automation software-update-configuration create --automation-account-name "myAutomationAccount"                  --resource-group "rg" -n mySoftwareUpdateConfiguration --frequency Hour --interval 1                  --operating-system windows --excluded-kb-numbers 16800,16800 -n confgname                  --included-update-classifications Critical --duration pT2H0M --azure-virtual-machines                  /subscriptions/{subid}/resourceGroups/{rg}/providers/Microsoft.Compute/virtualMachines/myVM

Parâmetros Exigidos

--automation-account-name

O nome da conta de automação.

--configuration-name --name -n

O nome da configuração da atualização de software.

--frequency

A frequência da agenda.

--interval

O intervalo da agenda.

--operating-system

Sistema operacional de computadores de destino.

Propriedade	Valor
Valores aceitos:	Linux, Windows

--resource-group -g

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

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.

--azure-queries-locations

Lista separada por espaço do local de consultas do Azure na configuração de atualização de software.

--azure-queries-scope

Lista separada por espaço do escopo de consultas do Azure na configuração de atualização de software.

--azure-queries-tags

Lista separada por espaço das configurações de marca de consultas do Azure na configuração de atualização de software.

--azure-virtual-machines

Lista separada por espaço de IDs de recursos do Azure para máquinas virtuais do Azure direcionadas pela configuração de atualização de software.

--creation-time

A hora de criação. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

--description

A descrição da agenda.

--duration

Tempo máximo permitido para a execução da configuração de atualização de software. A duração precisa ser especificada usando o formato PT[n]H[n]M[n]S de acordo com ISO8601.

--excluded-kb-numbers

Lista separada por espaço de números KB excluídos da configuração de atualização de software.

--expiry-time

A hora de término da agenda. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

--expiry-time-offset-minutes

O deslocamento do tempo de expiração em minutos.

--included-kb-numbers

Lista separada por espaço de números KB incluídos na configuração de atualização de software.

--included-update-classifications

Classificação de atualização incluída na configuração de atualização de software. Uma cadeia de caracteres separada por vírgulas com valores necessários.

--is-enabled

Indicando se esse agendamento está habilitado.

Propriedade	Valor
Valores aceitos:	false, true

--last-modified-time

A hora da última modificação. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

--next-run

A próxima hora de execução do agendamento. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

--next-run-offset-minutes

O deslocamento do próximo tempo de execução em minutos.

--non-azure-computer-names

Lista separada por espaço de nomes de computadores não azure direcionados pela configuração de atualização de software.

--non-azure-queries-function-alias

Nome da Pesquisa Salva do Log Analytics.

--non-azure-queries-workspace-id

ID do workspace para Log Analytics.

--post-task-job-id

A ID do trabalho da tarefa.

--post-task-source

O nome da origem da tarefa.

--post-task-status

O status da tarefa.

--pre-task-job-id

A ID do trabalho da tarefa.

--pre-task-source

O nome da origem da tarefa.

--pre-task-status

O status da tarefa.

--reboot-setting

Configuração de reinicialização para a configuração de atualização de software.

--start-time

A hora de início da agenda. Formato: data (yyyy-mm-dd) hora (hh:mm:ss.xxxxx) fuso horário (+/-hh:mm).

--time-zone

O fuso horário do agendamento.

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 automation software-update-configuration delete

Exclua uma configuração de atualização de software de automação.

az automation software-update-configuration delete --automation-account-name
                                                   --configuration-name --name
                                                   --resource-group
                                                   [--yes]

Exemplos

Excluir a configuração de atualização de software de automação

az automation software-update-configuration delete --name "mySoftwareUpdateConfiguration"                --resource-group "rg" --automation-account-name "myAutomationAccount"

Parâmetros Exigidos

--automation-account-name

O nome da conta de automação.

--configuration-name --name -n

O nome da configuração da atualização de software.

--resource-group -g

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

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.

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

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 automation software-update-configuration list

Liste todas as configurações de atualização de software para a conta.

az automation software-update-configuration list --automation-account-name
                                                 --resource-group

Exemplos

Listar configurações de atualização de software por conta de automação

az automation software-update-configuration list --automation-account-name "myAutomationAccount"                 --resource-group "rg"

Parâmetros Exigidos

--automation-account-name

O nome da conta de automação.

--resource-group -g

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

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 automation software-update-configuration show

Obtenha uma única configuração de atualização de software por nome.

az automation software-update-configuration show --automation-account-name
                                                 --configuration-name --name
                                                 --resource-group

Exemplos

Obter software-update-configuration

az automation software-update-configuration show --automation-account-name "myAutomationAccount"                --resource-group "rg" --name "mySoftwareUpdateConfiguration"

Parâmetros Exigidos

--automation-account-name

O nome da conta de automação.

--configuration-name --name -n

O nome da configuração da atualização de software.

--resource-group -g

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

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