Partilhar 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 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 Status
az maintenance configuration create

Crie um registro de configuração.

 Extension disponibilidade geral
az maintenance configuration delete

Excluir registro de configuração.

 Extension disponibilidade geral
az maintenance configuration list

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

 Extension disponibilidade geral
az maintenance configuration show

Obter registro de configuração.

 Extension disponibilidade geral
az maintenance configuration update

Atualize o registro de configuração.

 Extension disponibilidade geral

az maintenance configuration create

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

--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 tornar-se necessários para que o comando seja executado com êxito.

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

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

Obtém ou define extensionProperties da sintaxe abreviada maintenanceConfiguration Support, 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 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.

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

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

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

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

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 seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.

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

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

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Custom, Public
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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 subscrição. 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
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

--ids

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

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az maintenance configuration update

Atualize 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 tornar-se necessários para que o comando seja executado com êxito.

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

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

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

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--ids

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

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

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

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

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

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

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 seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.

Propriedade Valor
Grupo de parâmetros: InstallPatches Arguments
Valores aceites: 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 subscrição. 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 tags do recurso Suporte taquigrafia-sintaxe, 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 é 'Custom'.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Custom, Public
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False