Compartilhar via

az maintenance configuration

Note

Essa referência faz parte da extensão de manutenção da 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.

 Extension GA
az maintenance configuration delete

Excluir registro de configuração.

 Extension GA
az maintenance configuration list

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

 Extension GA
az maintenance configuration show

Obter registro de configuração.

 Extension GA
az maintenance configuration update

Atualizar o registro de configuração.

 Extension GA

az maintenance configuration create

Criar registro de configuração.

az maintenance configuration create --name --resource-name
                                    --resource-group
                                    [--duration --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --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

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.

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

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--extension-properties

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--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.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
--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.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
--location -l

Obtém ou define o local do recurso.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--maintenance-scope

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

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

Obtém ou define o namespace do recurso.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--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.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
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.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--visibility

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Custom, Public
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 maintenance configuration delete

Excluir registro de configuração.

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

Exemplos

MaintenanceConfigurations_DeleteForResource

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

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.

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name --resource-name -n

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

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: Resource Id Arguments
--subscription

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

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.

--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 maintenance configuration show

Obter registro de configuração.

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

Exemplos

MaintenanceConfigurations_GetForResource

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

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.

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name --resource-name -n

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

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: Resource Id Arguments
--subscription

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

az maintenance configuration update

Atualizar o registro de configuração.

az maintenance configuration update [--duration --maintenance-window-duration]
                                    [--expiration-date-time --maintenance-window-expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters --linux-parameters]
                                    [--install-patches-windows-parameters --windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every --recur-every]
                                    [--maintenance-window-start-date-time --start-date-time]
                                    [--maintenance-window-time-zone --time-zone]
                                    [--name --resource-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

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.

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

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--extension-properties

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--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'.

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

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
--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.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
--location -l

Obtém ou define o local do recurso.

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--maintenance-scope

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--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.

Propriedade Valor
Grupo de parâmetros: MaintenanceWindow Arguments
--name --resource-name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--namespace

Obtém ou define o namespace do recurso.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--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.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--tags

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

Propriedade Valor
Grupo de parâmetros: Configuration Arguments
--visibility

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Custom, Public
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.

--verbose

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

Propriedade Valor
Valor padrão: False