Compartir vía

az maintenance configuration

  • Referencia

Nota

Esta referencia forma parte de la extensión de mantenimiento de 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. 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.

 Extensión GA
az maintenance configuration delete

Eliminar registro de configuración.

 Extensión GA
az maintenance configuration list

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

 Extensión GA
az maintenance configuration show

Obtiene el registro de configuración.

 Extensión GA
az maintenance configuration update

Actualice el registro de configuración.

 Extensión GA

az maintenance configuration create

Cree un registro de configuración.

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

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

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

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

--extension-properties

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

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

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

--location -l

Obtiene o establece la ubicación del recurso.

--maintenance-scope

Obtiene o establece maintenanceScope de la configuración.

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.

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

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

--namespace

Obtiene o establece el espacio de nombres del recurso.

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

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.

--visibility

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

Valores aceptados: Custom, Public
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az maintenance configuration delete

Eliminar registro de configuración.

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

Ejemplos

MaintenanceConfigurations_DeleteForResource

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

Parámetros opcionales

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

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

--subscription

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

--yes -y

No solicite confirmación.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

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

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az maintenance configuration show

Obtiene el registro de configuración.

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

Ejemplos

MaintenanceConfigurations_GetForResource

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

Parámetros opcionales

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

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

--subscription

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az maintenance configuration update

Actualice el registro de configuración.

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

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

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

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

--extension-properties

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

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

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

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

--location -l

Obtiene o establece la ubicación del recurso.

--maintenance-scope

Obtiene o establece maintenanceScope de la configuración.

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.

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

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

--name --resource-name -n

Nombre de configuración de mantenimiento.

--namespace

Obtiene o establece el espacio de nombres del recurso.

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

Valores aceptados: Always, IfRequired, Never
--resource-group -g

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

--subscription

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

--tags

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

--visibility

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

Valores aceptados: Custom, Public
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.