Compartilhar via

az maintenance configuration

  • Referência

Observação

Essa referência faz parte da extensão de manutenção da CLI do Azure (versão 2.56.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az maintenance configuration . Saiba mais sobre extensões.

Gerencie 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 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 DD-MM-AAAA HH:MM. A janela será criada no fuso horário fornecido e ajustada ao horário de verão de acordo com esse fuso horário. A data de validade precisa ser definida para uma data futura. Se não for fornecida, ela será definida como o datetime máximo 31/12/9999 23h59m59s59.

--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 aplicação de patches em máquinas Linux. Para computadores Windows, não passe essa propriedade. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

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

Parâmetros de entrada específicos para aplicar patches em uma máquina Windows. Para máquinas Linux, não passe essa propriedade. Suporte taquigráfico-sintaxe, json-file 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 é esperada que uma janela de manutenção se repita. A taxa pode ser expressa como agendamento diário, semanal ou mensal. O agendamento diário é formatado como recurEvery: [Frequência como inteiro]['Dias']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agendamento diário são recurEvery: Day, recurEvery: 3Days. O agendamento semanal é formatado como recurEvery: [Frequência como inteiro]['Semanas'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agendamento semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. As agendas mensais são formatadas como [Frequência como inteiro]['Mês(es)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(es)'] [Semana do mês (primeiro, segundo, terceiro, quarto, último)] [Dia da semana de segunda a domingo] [Compensação opcional (Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6, inclusive. Exemplos de programação 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 DD-MM-AAAA 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 ao 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: Hora Oficial do Pacífico, UTC, Hora Oficial do Oeste Europeu, Hora Oficial da Coreia do Sul, Cen. Hora Oficial 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 na qual seria decidido reiniciar a máquina ou não após a conclusão da operação de patch.

valores aceitos: Always, IfRequired, Never
--tags

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

--visibility

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do 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 do 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do 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 do 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az maintenance configuration update

Atualizar 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 DD-MM-AAAA HH:MM. A janela será criada no fuso horário fornecido e ajustada ao horário de verão de acordo com esse fuso horário. A data de validade precisa ser definida para uma data futura. Se não for fornecida, ela será definida como o datetime máximo 31/12/9999 23h59m59s59.

--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 do recurso".

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

Parâmetros de entrada específicos para aplicação de patches em máquinas Linux. Para computadores Windows, não passe essa propriedade. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

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

Parâmetros de entrada específicos para aplicar patches em uma máquina Windows. Para máquinas Linux, não passe essa propriedade. Suporte taquigráfico-sintaxe, json-file 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 é esperada que uma janela de manutenção se repita. A taxa pode ser expressa como agendamento diário, semanal ou mensal. O agendamento diário é formatado como recurEvery: [Frequência como inteiro]['Dias']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agendamento diário são recurEvery: Day, recurEvery: 3Days. O agendamento semanal é formatado como recurEvery: [Frequência como inteiro]['Semanas'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agendamento semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. As agendas mensais são formatadas como [Frequência como inteiro]['Mês(es)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(es)'] [Semana do mês (primeiro, segundo, terceiro, quarto, último)] [Dia da semana de segunda a domingo] [Compensação opcional (Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6, inclusive. Exemplos de programação 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 DD-MM-AAAA 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 ao 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: Hora Oficial do Pacífico, UTC, Hora Oficial do Oeste Europeu, Hora Oficial da Coreia do Sul, Cen. Hora Oficial 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 na qual seria decidido reiniciar a máquina ou não após a conclusão da operação de patch.

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 Support shorthand-syntax, json-file e yaml-file. Tente "??" para mostrar mais.

--visibility

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.