Compartir a través de

az maintenance configuration

Note

Esta referencia forma parte de la extensión de mantenimiento para la CLI de Azure (versión 2.67.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az maintenance configuration. Obtenga más información sobre las extensiones.

Administrar la configuración de mantenimiento con mantenimiento.

Comandos

Nombre Description Tipo Estado
az maintenance configuration create

Cree un registro de configuración.

 Extension GA
az maintenance configuration delete

Eliminar registro de configuración.

 Extension GA
az maintenance configuration list

Enumera los registros de configuración dentro de una suscripción y un grupo de recursos.

 Extension GA
az maintenance configuration show

Obtiene el registro de configuración.

 Extension GA
az maintenance configuration update

Actualice el registro de configuración.

 Extension GA

az maintenance configuration create

Cree un registro de configuración.

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}]

Ejemplos

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 requeridos

--name --resource-name -n

Nombre de configuración de mantenimiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--duration --maintenance-window-duration

Duración de la ventana de mantenimiento en formato HH:mm. Si no se proporciona, se usará el valor predeterminado en función del ámbito de mantenimiento proporcionado. Ejemplo: 05:00.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--expiration-date-time --maintenance-window-expiration-date-time

Fecha de expiración efectiva de la ventana de mantenimiento en formato AAAA-MM-DD hh:mm. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria. La fecha de expiración debe establecerse en una fecha futura. Si no se proporciona, se establecerá en el valor máximo de datetime 9999-12-31 23:59:59.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--extension-properties

Obtiene o establece extensionProperties de la sintaxis abreviada maintenanceConfiguration Support, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--install-patches-linux-parameters --linux-parameters

Parámetros de entrada específicos para aplicar revisiones a la máquina Linux. En el caso de las máquinas Windows, no pase esta propiedad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
--install-patches-windows-parameters --windows-parameters

Parámetros de entrada específicos para aplicar revisiones a una máquina Windows. En el caso de las máquinas Linux, no pase esta propiedad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
--location -l

Obtiene o establece la ubicación del recurso.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--maintenance-scope

Obtiene o establece maintenanceScope de la configuración.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Velocidad a la que se espera que se repita una ventana de mantenimiento. La tasa se puede expresar como programaciones diarias, semanales o mensuales. La programación diaria tiene el formato recurEvery: [Frecuencia como entero]['Día(s)']. Si no se proporciona ninguna frecuencia, la frecuencia predeterminada es 1. Los ejemplos de programación diaria son recurEvery: Day, recurEvery: 3Days. La programación semanal tiene el formato recurEvery: [Frecuencia como entero]['Semana(s)'] [Lista opcional separada por comas de días laborables de lunes a domingo]. Los ejemplos de programación semanal son recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Las programaciones mensuales tienen el formato [Frecuencia como entero]['Mes(s)'] [Lista separada por comas de días del mes] o [Frecuencia como entero]['Mes(s)'] [Semana del mes (Primera, Segunda, Tercera, Cuarta, Última)] [Día de lunes a domingo] [Desplazamiento opcional(No. de días)]. El valor de desplazamiento debe estar entre -6 y 6 inclusive. Los ejemplos de programación mensual son 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.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--maintenance-window-start-date-time --start-date-time

Fecha de inicio efectiva de la ventana de mantenimiento en formato AAAA-MM-DD hh:mm. La fecha de inicio se puede establecer en la fecha actual o en la fecha futura. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--maintenance-window-time-zone --time-zone

Nombre de la zona horaria. La lista de zonas horarias se puede obtener ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Ejemplo: Hora estándar del Pacífico, UTC, Hora estándar de W. Europa, Hora estándar de Corea, Cen. Hora estándar de Australia.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--namespace

Obtiene o establece el espacio de nombres del recurso.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--reboot-setting

Posible preferencia de reinicio según lo definido por el usuario en función de la cual se decidiría reiniciar la máquina o no después de que se complete la operación de revisión.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
Valores aceptados: Always, IfRequired, Never
--tags

Obtiene o establece etiquetas del recurso Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--visibility

Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom".

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Custom, Public
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az maintenance configuration delete

Eliminar registro de configuración.

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

Ejemplos

MaintenanceConfigurations_DeleteForResource

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name --resource-name -n

Nombre de configuración de mantenimiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az maintenance configuration list

Enumera los registros de configuración dentro de una suscripción y un grupo de recursos.

az maintenance configuration list [--resource-group]

Ejemplos

MaintenanceConfigurations_List

az maintenance configuration list

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az maintenance configuration show

Obtiene el registro de configuración.

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

Ejemplos

MaintenanceConfigurations_GetForResource

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name --resource-name -n

Nombre de configuración de mantenimiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az maintenance configuration update

Actualice el registro de configuración.

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}]

Ejemplos

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 opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--duration --maintenance-window-duration

Duración de la ventana de mantenimiento en formato HH:mm. Si no se proporciona, se usará el valor predeterminado en función del ámbito de mantenimiento proporcionado. Ejemplo: 05:00.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--expiration-date-time --maintenance-window-expiration-date-time

Fecha de expiración efectiva de la ventana de mantenimiento en formato AAAA-MM-DD hh:mm. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria. La fecha de expiración debe establecerse en una fecha futura. Si no se proporciona, se establecerá en el valor máximo de datetime 9999-12-31 23:59:59.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--extension-properties

Obtiene o establece extensionProperties de la sintaxis abreviada maintenanceConfiguration Support, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--install-patches-linux-parameters --linux-parameters

Parámetros de entrada específicos para aplicar revisiones a la máquina Linux. En el caso de las máquinas Windows, no pase esta propiedad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
--install-patches-windows-parameters --windows-parameters

Parámetros de entrada específicos para aplicar revisiones a una máquina Windows. En el caso de las máquinas Linux, no pase esta propiedad. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
--location -l

Obtiene o establece la ubicación del recurso.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--maintenance-scope

Obtiene o establece maintenanceScope de la configuración.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Velocidad a la que se espera que se repita una ventana de mantenimiento. La tasa se puede expresar como programaciones diarias, semanales o mensuales. La programación diaria tiene el formato recurEvery: [Frecuencia como entero]['Día(s)']. Si no se proporciona ninguna frecuencia, la frecuencia predeterminada es 1. Los ejemplos de programación diaria son recurEvery: Day, recurEvery: 3Days. La programación semanal tiene el formato recurEvery: [Frecuencia como entero]['Semana(s)'] [Lista opcional separada por comas de días laborables de lunes a domingo]. Los ejemplos de programación semanal son recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Las programaciones mensuales tienen el formato [Frecuencia como entero]['Mes(s)'] [Lista separada por comas de días del mes] o [Frecuencia como entero]['Mes(s)'] [Semana del mes (Primera, Segunda, Tercera, Cuarta, Última)] [Día de lunes a domingo] [Desplazamiento opcional(No. de días)]. El valor de desplazamiento debe estar entre -6 y 6 inclusive. Los ejemplos de programación mensual son 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.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--maintenance-window-start-date-time --start-date-time

Fecha de inicio efectiva de la ventana de mantenimiento en formato AAAA-MM-DD hh:mm. La fecha de inicio se puede establecer en la fecha actual o en la fecha futura. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--maintenance-window-time-zone --time-zone

Nombre de la zona horaria. La lista de zonas horarias se puede obtener ejecutando [System.TimeZoneInfo]::GetSystemTimeZones() en PowerShell. Ejemplo: Hora estándar del Pacífico, UTC, Hora estándar de W. Europa, Hora estándar de Corea, Cen. Hora estándar de Australia.

Propiedad Valor
Grupo de parámetros: MaintenanceWindow Arguments
--name --resource-name -n

Nombre de configuración de mantenimiento.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--namespace

Obtiene o establece el espacio de nombres del recurso.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--reboot-setting

Posible preferencia de reinicio según lo definido por el usuario en función de la cual se decidiría reiniciar la máquina o no después de que se complete la operación de revisión.

Propiedad Valor
Grupo de parámetros: InstallPatches Arguments
Valores aceptados: Always, IfRequired, Never
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--tags

Obtiene o establece etiquetas del recurso Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Configuration Arguments
--visibility

Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom".

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Custom, Public
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False