az maintenance configuration
Nota:
Esta referencia forma parte de la extensión de mantenimiento para la CLI de Azure (versión 2.56.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. |
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
Nombre de configuración de mantenimiento.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros opcionales
Duración de la ventana de mantenimiento en formato HH:mm. Si no se proporciona, se usará el valor predeterminado según el ámbito de mantenimiento proporcionado. Ejemplo: 05:00.
Fecha de expiración en vigor 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 fecha y hora: 9999-12-31 23:59:59.
Obtiene o establece extensionProperties de la sintaxis abreviada maintenanceConfiguration Support, json-file y yaml-file. Intenta "??" para mostrar más.
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.
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.
Obtiene o establece la ubicación del recurso.
Obtiene o establece maintenanceScope de la configuración.
Frecuencia a la que se espera que se repita una ventana de Mantenimiento. La frecuencia puede expresarse como programaciones diarias, semanales o mensuales. La programación diaria tiene el formato recurEvery: [Frecuencia como un número 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 un número entero][«Semana(s)»] [Lista opcional separada por comas de los 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 comprendido 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.
Fecha de inicio en vigor 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 una fecha futura. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria.
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, hora universal coordinada, hora estándar de Europa, hora estándar de Corea, Cen. Hora estándar de Australia.
Obtiene o establece el espacio de nombres del recurso.
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.
Obtiene o establece etiquetas del recurso Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener 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
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Nombre de configuración de mantenimiento.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener 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
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener 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
Uno o varios identificadores de recursos (delimitados por espacios). 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".
Nombre de configuración de mantenimiento.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener 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
Duración de la ventana de mantenimiento en formato HH:mm. Si no se proporciona, se usará el valor predeterminado según el ámbito de mantenimiento proporcionado. Ejemplo: 05:00.
Fecha de expiración en vigor 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 fecha y hora: 9999-12-31 23:59:59.
Obtiene o establece extensionProperties de la sintaxis abreviada maintenanceConfiguration Support, json-file y yaml-file. Intenta "??" para mostrar más.
Uno o varios identificadores de recursos (delimitados por espacios). 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".
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.
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.
Obtiene o establece la ubicación del recurso.
Obtiene o establece maintenanceScope de la configuración.
Frecuencia a la que se espera que se repita una ventana de Mantenimiento. La frecuencia puede expresarse como programaciones diarias, semanales o mensuales. La programación diaria tiene el formato recurEvery: [Frecuencia como un número 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 un número entero][«Semana(s)»] [Lista opcional separada por comas de los 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 comprendido 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.
Fecha de inicio en vigor 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 una fecha futura. La ventana se creará en la zona horaria proporcionada y se ajustará al horario de verano según esa zona horaria.
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, hora universal coordinada, hora estándar de Europa, hora estándar de Corea, Cen. Hora estándar de Australia.
Nombre de configuración de mantenimiento.
Obtiene o establece el espacio de nombres del recurso.
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.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Obtiene o establece etiquetas del recurso Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.
Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de