az maintenance configuration

Nota

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

Name Description Tipo Estado
az maintenance configuration create

Crie um 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 dentro de 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

Atualize o registro de configuração.

Extensão GA

az maintenance configuration create

Crie um 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 Obrigatórios

--name --resource-name -n

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

--resource-group -g

o 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 expiração efetiva da janela de manutenção no formato AAAA-MM-DD 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 expiração deve ser definida para uma data futura. Se não for fornecido, será definido para a data/hora máxima 9999-12-31 23:59:59.

--extension-properties

Obtém ou define extensionProperties da sintaxe abreviada maintenanceConfiguration Support, 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 patches na máquina Linux. Para máquinas Windows, não passe esta propriedade. Suporta sintaxe taquigráfica, 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 esta propriedade. Suporta sintaxe taquigráfica, 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 aceites: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Taxa na qual se espera que uma janela de Manutenção se repita. A taxa pode ser expressa em horários diários, semanais ou mensais. A programação diária é formatada como recorrente: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de horários diários são recorrentes: Dia, recorrentes: 3Dias. A programação semanal é formatada como recorrente: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias úteis de segunda a domingo]. Exemplos de programação semanal são recorrentes: 3Weeks, recurEvery: Semana sábado, domingo. 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, Terceira, Quarta, Última, Última)] [Dia da Semana de Segunda a Domingo] [Compensação Opcional(Nº de dias)]. O valor de deslocamento deve estar entre -6 a 6, inclusive. Exemplos de programação mensal são recorrentesEvery: 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 AAAA-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 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 Padrão do Pacífico, UTC, Hora Padrão da Europa W., 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 seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.

valores aceites: Always, IfRequired, Never
--tags

Obtém ou define tags do recurso Suporte taquigrafia-sintaxe, 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 aceites: Custom, Public
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --resource-name -n

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

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az maintenance configuration list

Listar registros de configuração dentro de 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

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --resource-name -n

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

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az maintenance configuration update

Atualize 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 expiração efetiva da janela de manutenção no formato AAAA-MM-DD 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 expiração deve ser definida para uma data futura. Se não for fornecido, será definido para a data/hora máxima 9999-12-31 23:59:59.

--extension-properties

Obtém ou define extensionProperties da sintaxe abreviada maintenanceConfiguration Support, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Parâmetros de entrada específicos para a aplicação de patches na máquina Linux. Para máquinas Windows, não passe esta propriedade. Suporta sintaxe taquigráfica, 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 esta propriedade. Suporta sintaxe taquigráfica, 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 aceites: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Taxa na qual se espera que uma janela de Manutenção se repita. A taxa pode ser expressa em horários diários, semanais ou mensais. A programação diária é formatada como recorrente: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de horários diários são recorrentes: Dia, recorrentes: 3Dias. A programação semanal é formatada como recorrente: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias úteis de segunda a domingo]. Exemplos de programação semanal são recorrentes: 3Weeks, recurEvery: Semana sábado, domingo. 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, Terceira, Quarta, Última, Última)] [Dia da Semana de Segunda a Domingo] [Compensação Opcional(Nº de dias)]. O valor de deslocamento deve estar entre -6 a 6, inclusive. Exemplos de programação mensal são recorrentesEvery: 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 AAAA-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 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 Padrão do Pacífico, UTC, Hora Padrão da Europa W., 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 seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.

valores aceites: Always, IfRequired, Never
--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

Obtém ou define tags do recurso Suporte taquigrafia-sintaxe, 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 aceites: Custom, Public
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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