Compartilhar via

az maintenance configuration

  • Referência

Nota

Essa referência faz parte da extensão de manutenção para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de configuração de manutenção do az . Saiba mais sobre extensões.

Gerenciar a configuração de manutenção com manutenção.

Comandos

Nome Description Tipo Status
az maintenance configuration create

Criar registro de configuração.

 Extensão GA
az maintenance configuration delete

Excluir registro de configuração.

 Extensão GA
az maintenance configuration list

Listar registros de configuração em uma assinatura e grupo de recursos.

 Extensão GA
az maintenance configuration show

Obter registro de configuração.

 Extensão GA
az maintenance configuration update

Atualizar o registro de configuração.

 Extensão GA

az maintenance configuration create

Criar registro de configuração.

az maintenance configuration create --name
                                    --resource-group
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Exemplos

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Day" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Parâmetros Exigidos

--name --resource-name -n

Nome da configuração de manutenção.

--resource-group -g

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

Parâmetros Opcionais

--duration --maintenance-window-duration

Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor padrão será usado com base no escopo de manutenção fornecido. Exemplo: 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

Data de validade efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. A data de validade deve ser definida como uma data futura. Se não for fornecido, ele será definido como o datetime máximo 9999-12-31 23:59:59.

--extension-properties

Obtém ou define extensionProperties do maintenanceConfiguration Support shorthand-syntax, json-file e yaml-file. Tente "??" para mostrar mais.

--install-patches-linux-parameters --linux-parameters

Parâmetros de entrada específicos para a aplicação de patch do computador Linux. Para computadores Windows, não passe essa propriedade. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--install-patches-windows-parameters --windows-parameters

Parâmetros de entrada específicos para aplicação de patch em um computador Windows. Para computadores Linux, não passe essa propriedade. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--location -l

Obtém ou define o local do recurso.

--maintenance-scope

Obtém ou define maintenanceScope da configuração.

Valores aceitos: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Taxa na qual espera-se que uma janela de manutenção se repita. A taxa pode ser expressa como agendas diárias, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Os agendamentos mensais são formatados como [Frequência como inteiro]['Mês(s)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(s)'] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana De Segunda a Domingo] [Deslocamento Opcional(Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6 inclusive. Exemplos de agenda mensal são recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Data de início efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A data de início pode ser definida como a data atual ou a data futura. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário.

--maintenance-window-time-zone --time-zone

Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Horário Padrão do Pacífico, UTC, Horário Padrão da Europa, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália.

--namespace

Obtém ou define o namespace do recurso.

--reboot-setting

Possível preferência de reinicialização, conforme definido pelo usuário com base no qual ele seria decidido reinicializar o computador ou não depois que a operação de patch for concluída.

Valores aceitos: Always, IfRequired, Never
--tags

Obtém ou define marcas do recurso Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--visibility

Obtém ou define a visibilidade da configuração. O valor padrão é 'Personalizado'.

Valores aceitos: Custom, Public
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az maintenance configuration delete

Excluir registro de configuração.

az maintenance configuration delete [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Exemplos

MaintenanceConfigurations_DeleteForResource

az maintenance configuration delete --resource-group "examplerg" --resource-name "example1"

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name --resource-name -n

Nome da configuração de manutenção.

--resource-group -g

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

--subscription

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

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az maintenance configuration list

Listar registros de configuração em uma assinatura e grupo de recursos.

az maintenance configuration list [--resource-group]

Exemplos

MaintenanceConfigurations_List

az maintenance configuration list

Parâmetros Opcionais

--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.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az maintenance configuration show

Obter registro de configuração.

az maintenance configuration show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Exemplos

MaintenanceConfigurations_GetForResource

az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name --resource-name -n

Nome da configuração de manutenção.

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az maintenance configuration update

Atualizar o registro de configuração.

az maintenance configuration update [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--name]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Exemplos

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Month Third Sunday" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Parâmetros Opcionais

--duration --maintenance-window-duration

Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor padrão será usado com base no escopo de manutenção fornecido. Exemplo: 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

Data de validade efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. A data de validade deve ser definida como uma data futura. Se não for fornecido, ele será definido como o datetime máximo 9999-12-31 23:59:59.

--extension-properties

Obtém ou define extensionProperties do maintenanceConfiguration Support shorthand-syntax, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--install-patches-linux-parameters --linux-parameters

Parâmetros de entrada específicos para a aplicação de patch do computador Linux. Para computadores Windows, não passe essa propriedade. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--install-patches-windows-parameters --windows-parameters

Parâmetros de entrada específicos para aplicação de patch em um computador Windows. Para computadores Linux, não passe essa propriedade. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--location -l

Obtém ou define o local do recurso.

--maintenance-scope

Obtém ou define maintenanceScope da configuração.

Valores aceitos: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Taxa na qual espera-se que uma janela de manutenção se repita. A taxa pode ser expressa como agendas diárias, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Os agendamentos mensais são formatados como [Frequência como inteiro]['Mês(s)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(s)'] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana De Segunda a Domingo] [Deslocamento Opcional(Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6 inclusive. Exemplos de agenda mensal são recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Data de início efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A data de início pode ser definida como a data atual ou a data futura. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário.

--maintenance-window-time-zone --time-zone

Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Horário Padrão do Pacífico, UTC, Horário Padrão da Europa, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália.

--name --resource-name -n

Nome da configuração de manutenção.

--namespace

Obtém ou define o namespace do recurso.

--reboot-setting

Possível preferência de reinicialização, conforme definido pelo usuário com base no qual ele seria decidido reinicializar o computador ou não depois que a operação de patch for concluída.

Valores aceitos: Always, IfRequired, Never
--resource-group -g

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

--subscription

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

--tags

Obtém ou define marcas do recurso Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--visibility

Obtém ou define a visibilidade da configuração. O valor padrão é 'Personalizado'.

Valores aceitos: Custom, Public
Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.