Compartir a través de

Mantenimiento De Microsoft.MaintenanceConfigurations

  • Artículo

Definición de recursos de Bicep

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

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

Formato de los recursos

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

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    extensionProperties: {}
    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

maintenanceConfigurations

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

MaintenanceConfigurationProperties

Nombre Descripción Valor
extensionProperties Obtiene o establece el valor de extensionProperties de maintenanceConfiguration object
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 en la configuración 'Extensión'
'Host'
'InGuestPatch'
'OSImage'
'Recurso'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definición de un objeto MaintenanceWindow MaintenanceWindow
espacio de nombres Obtiene o establece el espacio de nombres del recurso string
visibilidad Obtiene o establece la visibilidad de la configuración. El valor predeterminado es «Personalizado» 'Personalizado'
"Público"

InputPatchConfiguration

Nombre Descripción Valor
linuxParameters Parámetros de entrada específicos de la aplicación de 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. "Siempre"
"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

InputLinuxParameters

Nombre Descripción Valor
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
packageNameMasksToExclude Nombres de paquete que se excluirán para la aplicación de revisiones. string[]
packageNameMasksToInclude Nombres de paquete que se incluirán para la aplicación de revisiones. string[]

InputWindowsParameters

Nombre Descripción Valor
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
excludeKbsRequiringReboot Exclusión de revisiones que necesitan reiniciar bool
kbNumbersToExclude Windows KBID que se va a excluir para la aplicación de revisiones. string[]
kbNumbersToInclude Windows KBID que se va a incluir para la aplicación de revisiones. string[]

MaintenanceWindow

Nombre Descripción Valor
duration 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. string
expirationDateTime 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. string
recurEvery 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. 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]. Ejemplos de programación semanal son recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Las programaciones mensuales tienen el formato [Frequency as integer]['Month(s)'] [Comma separated list of month days] or [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. 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. string
startDateTime 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. string
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, hora universal coordinada, hora estándar de Europa, hora estándar de Corea, Cen. Hora estándar de Australia. string

Definición de recursos de plantilla de ARM

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

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

Formato de los recursos

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

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "extensionProperties": {},
    "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

maintenanceConfigurations

Nombre Descripción Value
type Tipo de recurso 'Microsoft.Maintenance/maintenanceConfigurations'
apiVersion La versión de la API de recursos '2023-04-01'
name El nombre del recurso string (obligatorio)
ubicación Obtiene o establece la ubicación del recurso string
etiquetas Obtiene o establece las etiquetas del recurso Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Obtiene o establece las propiedades del recurso. MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

Nombre Descripción Valor
extensionProperties Obtiene o establece el valor de extensionProperties de maintenanceConfiguration object
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 en la configuración 'Extensión'
'Host'
'InGuestPatch'
'OSImage'
'Recurso'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definición de un objeto MaintenanceWindow MaintenanceWindow
espacio de nombres Obtiene o establece el espacio de nombres del recurso string
visibilidad Obtiene o establece la visibilidad de la configuración. El valor predeterminado es «Personalizado» 'Personalizado'
'Público'

InputPatchConfiguration

Nombre Descripción Value
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. "Siempre"
'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

InputLinuxParameters

Nombre Descripción Valor
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
packageNameMasksToExclude Nombres de paquete que se excluirán para la aplicación de revisiones. string[]
packageNameMasksToInclude Nombres de paquete que se van a incluir para la aplicación de revisiones. string[]

InputWindowsParameters

Nombre Descripción Valor
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
excludeKbsRequiringReboot Exclusión de revisiones que necesitan reiniciar bool
kbNumbersToExclude Windows KBID que se va a excluir para la aplicación de revisiones. string[]
kbNumbersToInclude Windows KBID que se va a incluir para la aplicación de revisiones. string[]

MaintenanceWindow

Nombre Descripción Valor
duration 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. string
expirationDateTime 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. string
recurEvery 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. 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]. Ejemplos de programación semanal son recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Las programaciones mensuales tienen el formato [Frequency as integer]['Month(s)'] [Comma separated list of month days] or [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. 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. string
startDateTime 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. string
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, hora universal coordinada, hora estándar de Europa, hora estándar de Corea, Cen. Hora estándar de Australia. string

Definición de recursos de Terraform (proveedor AzAPI)

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

  • Grupos de recursos

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

Formato de los recursos

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      extensionProperties = {}
      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

maintenanceConfigurations

Nombre Descripción Value
type Tipo de recurso "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
name El nombre del recurso string (obligatorio)
ubicación Obtiene o establece la ubicación del recurso string
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Obtiene o establece las etiquetas del recurso Diccionario de nombres y valores de etiqueta.
properties Obtiene o establece las propiedades del recurso. MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

Nombre Descripción Value
extensionProperties Obtiene o establece el valor de extensionProperties de maintenanceConfiguration object
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 en la configuración "Extensión"
"Host"
"InGuestPatch"
"OSImage"
"Resource"
"SQLDB"
"SQLManagedInstance"
maintenanceWindow Definición de un objeto MaintenanceWindow MaintenanceWindow
espacio de nombres Obtiene o establece el espacio de nombres del recurso string
visibilidad Obtiene o establece la visibilidad de la configuración. El valor predeterminado es «Personalizado» "Custom"
"Público"

InputPatchConfiguration

Nombre Descripción Value
linuxParameters Parámetros de entrada específicos de la aplicación de 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. "Siempre"
"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

InputLinuxParameters

Nombre Descripción Value
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
packageNameMasksToExclude Nombres de paquete que se excluirán para la aplicación de revisiones. string[]
packageNameMasksToInclude Nombres de paquete que se incluirán para la aplicación de revisiones. string[]

InputWindowsParameters

Nombre Descripción Valor
classificationsToInclude Categoría de clasificación de revisiones que se van a aplicar revisiones string[]
excludeKbsRequiringReboot Exclusión de revisiones que necesitan reiniciar bool
kbNumbersToExclude Windows KBID que se va a excluir para la aplicación de revisiones. string[]
kbNumbersToInclude Windows KBID que se va a incluir para la aplicación de revisiones. string[]

MaintenanceWindow

Nombre Descripción Valor
duration 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. string
expirationDateTime 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. string
recurEvery 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. 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]. Ejemplos de programación semanal son recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Las programaciones mensuales tienen el formato [Frequency as integer]['Month(s)'] [Comma separated list of month days] or [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. 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. string
startDateTime 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. string
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, hora universal coordinada, hora estándar de Europa, hora estándar de Corea, Cen. Hora estándar de Australia. string