Mantenimiento de Microsoft.MaintenanceConfigurations

Artículo
01/28/2025

Definición de recursos de Bicep

El tipo de recurso maintenanceConfigurations se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Maintenance/maintenanceConfigurations, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    extensionProperties: {
      {customized property}: 'string'
    }
    installPatches: {
      linuxParameters: {
        classificationsToInclude: [
          'string'
        ]
        packageNameMasksToExclude: [
          'string'
        ]
        packageNameMasksToInclude: [
          'string'
        ]
      }
      rebootSetting: 'string'
      windowsParameters: {
        classificationsToInclude: [
          'string'
        ]
        excludeKbsRequiringReboot: bool
        kbNumbersToExclude: [
          'string'
        ]
        kbNumbersToInclude: [
          'string'
        ]
      }
    }
    maintenanceScope: 'string'
    maintenanceWindow: {
      duration: 'string'
      expirationDateTime: 'string'
      recurEvery: 'string'
      startDateTime: 'string'
      timeZone: 'string'
    }
    namespace: 'string'
    visibility: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

InputLinuxParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security" y "Other".	string[]
packageNameMasksToExclude	Nombres de paquete que se excluirán para aplicar revisiones.	string[]
packageNameMasksToInclude	Nombres de paquete que se van a incluir para la aplicación de revisiones.	string[]

InputPatchConfiguration

Nombre	Descripción	Valor
linuxParameters	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.	InputLinuxParameters
rebootSetting	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.	'Always' 'IfRequired' 'Nunca'
windowsParameters	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.	inputWindowsParameters

InputWindowsParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security", "UpdateRollup", "FeaturePack", "ServicePack", "Definition", "Tools" y "Updates".	string[]
excludeKbsRequiringReboot	Exclusión de revisiones que necesitan reiniciar	Bool
kbNumbersToExclude	Windows KBID que se va a excluir para aplicar revisiones.	string[]
kbNumbersToInclude	KbID de Windows que se va a incluir para la aplicación de revisiones.	string[]

MaintenanceConfigurationProperties

Nombre	Descripción	Valor
extensionProperties	Obtiene o establece extensionProperties de maintenanceConfiguration.	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parámetros de entrada que se van a pasar a la operación de ejecución de revisiones.	InputPatchConfiguration
maintenanceScope	Obtiene o establece maintenanceScope de la configuración	'Extensión' 'Host' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definición de un objeto MaintenanceWindow	MaintenanceWindow
Namespace	Obtiene o establece el espacio de nombres del recurso.	cuerda
visibilidad	Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom"	'Personalizado' 'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nombre	Descripción	Valor

MaintenanceConfigurationTags

Nombre	Descripción	Valor

MaintenanceWindow

Nombre	Descripción	Valor
duración	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.	cuerda
expirationDateTime	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.	cuerda
recurEvery	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.	cuerda
startDateTime	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.	cuerda
timeZone	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.	cuerda

Microsoft.Maintenance/maintenanceConfigurations

Nombre	Descripción	Valor
ubicación	Obtiene o establece la ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Obtiene o establece las propiedades del recurso.	MaintenanceConfigurationProperties
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

Definición de recursos de plantilla de ARM

El tipo de recurso maintenanceConfigurations se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Maintenance/maintenanceConfigurations, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "extensionProperties": {
      "{customized property}": "string"
    },
    "installPatches": {
      "linuxParameters": {
        "classificationsToInclude": [ "string" ],
        "packageNameMasksToExclude": [ "string" ],
        "packageNameMasksToInclude": [ "string" ]
      },
      "rebootSetting": "string",
      "windowsParameters": {
        "classificationsToInclude": [ "string" ],
        "excludeKbsRequiringReboot": "bool",
        "kbNumbersToExclude": [ "string" ],
        "kbNumbersToInclude": [ "string" ]
      }
    },
    "maintenanceScope": "string",
    "maintenanceWindow": {
      "duration": "string",
      "expirationDateTime": "string",
      "recurEvery": "string",
      "startDateTime": "string",
      "timeZone": "string"
    },
    "namespace": "string",
    "visibility": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

InputLinuxParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security" y "Other".	string[]
packageNameMasksToExclude	Nombres de paquete que se excluirán para aplicar revisiones.	string[]
packageNameMasksToInclude	Nombres de paquete que se van a incluir para la aplicación de revisiones.	string[]

InputPatchConfiguration

Nombre	Descripción	Valor
linuxParameters	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.	InputLinuxParameters
rebootSetting	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.	'Always' 'IfRequired' 'Nunca'
windowsParameters	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.	inputWindowsParameters

InputWindowsParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security", "UpdateRollup", "FeaturePack", "ServicePack", "Definition", "Tools" y "Updates".	string[]
excludeKbsRequiringReboot	Exclusión de revisiones que necesitan reiniciar	Bool
kbNumbersToExclude	Windows KBID que se va a excluir para aplicar revisiones.	string[]
kbNumbersToInclude	KbID de Windows que se va a incluir para la aplicación de revisiones.	string[]

MaintenanceConfigurationProperties

Nombre	Descripción	Valor
extensionProperties	Obtiene o establece extensionProperties de maintenanceConfiguration.	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parámetros de entrada que se van a pasar a la operación de ejecución de revisiones.	InputPatchConfiguration
maintenanceScope	Obtiene o establece maintenanceScope de la configuración	'Extensión' 'Host' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definición de un objeto MaintenanceWindow	MaintenanceWindow
Namespace	Obtiene o establece el espacio de nombres del recurso.	cuerda
visibilidad	Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom"	'Personalizado' 'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nombre	Descripción	Valor

MaintenanceConfigurationTags

Nombre	Descripción	Valor

MaintenanceWindow

Nombre	Descripción	Valor
duración	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.	cuerda
expirationDateTime	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.	cuerda
recurEvery	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.	cuerda
startDateTime	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.	cuerda
timeZone	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.	cuerda

Microsoft.Maintenance/maintenanceConfigurations

Nombre	Descripción	Valor
apiVersion	La versión de api	'2023-10-01-preview'
ubicación	Obtiene o establece la ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Obtiene o establece las propiedades del recurso.	MaintenanceConfigurationProperties
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	"Microsoft.Maintenance/maintenanceConfigurations"

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso maintenanceConfigurations se puede implementar con operaciones destinadas a:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Maintenance/maintenanceConfigurations, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      extensionProperties = {
        {customized property} = "string"
      }
      installPatches = {
        linuxParameters = {
          classificationsToInclude = [
            "string"
          ]
          packageNameMasksToExclude = [
            "string"
          ]
          packageNameMasksToInclude = [
            "string"
          ]
        }
        rebootSetting = "string"
        windowsParameters = {
          classificationsToInclude = [
            "string"
          ]
          excludeKbsRequiringReboot = bool
          kbNumbersToExclude = [
            "string"
          ]
          kbNumbersToInclude = [
            "string"
          ]
        }
      }
      maintenanceScope = "string"
      maintenanceWindow = {
        duration = "string"
        expirationDateTime = "string"
        recurEvery = "string"
        startDateTime = "string"
        timeZone = "string"
      }
      namespace = "string"
      visibility = "string"
    }
  })
}

Valores de propiedad

InputLinuxParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security" y "Other".	string[]
packageNameMasksToExclude	Nombres de paquete que se excluirán para aplicar revisiones.	string[]
packageNameMasksToInclude	Nombres de paquete que se van a incluir para la aplicación de revisiones.	string[]

InputPatchConfiguration

Nombre	Descripción	Valor
linuxParameters	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.	InputLinuxParameters
rebootSetting	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.	'Always' 'IfRequired' 'Nunca'
windowsParameters	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.	inputWindowsParameters

InputWindowsParameters

Nombre	Descripción	Valor
classificationsToInclude	Categoría de clasificación de revisiones que se va a aplicar a la revisión. Los valores permitidos son "Critical", "Security", "UpdateRollup", "FeaturePack", "ServicePack", "Definition", "Tools" y "Updates".	string[]
excludeKbsRequiringReboot	Exclusión de revisiones que necesitan reiniciar	Bool
kbNumbersToExclude	Windows KBID que se va a excluir para aplicar revisiones.	string[]
kbNumbersToInclude	KbID de Windows que se va a incluir para la aplicación de revisiones.	string[]

MaintenanceConfigurationProperties

Nombre	Descripción	Valor
extensionProperties	Obtiene o establece extensionProperties de maintenanceConfiguration.	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Parámetros de entrada que se van a pasar a la operación de ejecución de revisiones.	InputPatchConfiguration
maintenanceScope	Obtiene o establece maintenanceScope de la configuración	'Extensión' 'Host' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
maintenanceWindow	Definición de un objeto MaintenanceWindow	MaintenanceWindow
Namespace	Obtiene o establece el espacio de nombres del recurso.	cuerda
visibilidad	Obtiene o establece la visibilidad de la configuración. El valor predeterminado es "Custom"	'Personalizado' 'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nombre	Descripción	Valor

MaintenanceConfigurationTags

Nombre	Descripción	Valor

MaintenanceWindow

Nombre	Descripción	Valor
duración	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.	cuerda
expirationDateTime	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.	cuerda
recurEvery	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.	cuerda
startDateTime	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.	cuerda
timeZone	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.	cuerda

Microsoft.Maintenance/maintenanceConfigurations

Nombre	Descripción	Valor
ubicación	Obtiene o establece la ubicación del recurso.	cuerda
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Obtiene o establece las propiedades del recurso.	MaintenanceConfigurationProperties
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"

Compartir a través de

Mantenimiento de Microsoft.MaintenanceConfigurations

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfigurationProperties

MaintenanceConfigurationPropertiesExtensionProperties

MaintenanceConfigurationTags

MaintenanceWindow

Microsoft.Maintenance/maintenanceConfigurations

Comentarios

Recursos adicionales