Compartilhar via

Microsoft.Maintenance maintenanceConfigurations 2023-04-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso maintenanceConfigurations pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Maintenance/maintenanceConfigurations, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Maintenance/maintenanceConfigurations@2023-04-01' = {
  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 propriedade

InputLinuxParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
packageNameMasksToExclude Nomes de pacote a serem excluídos para aplicação de patch. string[]
packageNameMasksToInclude Nomes de pacote a serem incluídos para aplicação de patch. string[]

InputPatchConfiguration

Nome Descrição Valor
linuxParameters Parâmetros de entrada específicos para a aplicação de patch do computador Linux. Para computadores Windows, não passe essa propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinicialização, conforme definido pelo usuário com base no qual ele seria decidido reinicializar o computador ou não depois que a operação de patch for concluída. 'Always'
'IfRequired'
'Nunca'
windowsParameters Parâmetros de entrada específicos para aplicação de patch em um computador Windows. Para computadores Linux, não passe essa propriedade. InputWindowsParameters

InputWindowsParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
excludeKbsRequiringReboot Excluir patches que precisam ser reinicializados Bool
kbNumbersToExclude O KBID do Windows a ser excluído para aplicação de patch. string[]
kbNumbersToInclude O KBID do Windows a ser incluído para aplicação de patch. string[]

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da maintenanceConfiguration MaintenanceConfigurationPropertiesExtensionProperties
installPatches Os parâmetros de entrada a serem passados para a operação de execução de patch. InputPatchConfiguration
maintenanceScope Obtém ou define maintenanceScope da configuração 'Extensão'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definição de um MaintenanceWindow MaintenanceWindow
Namespace Obtém ou define o namespace do recurso corda
visibilidade Obtém ou define a visibilidade da configuração. O valor padrão é 'Personalizado' 'Personalizado'
'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nome Descrição Valor

MaintenanceConfigurationTags

Nome Descrição Valor

MaintenanceWindow

Nome Descrição Valor
duração Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor padrão será usado com base no escopo de manutenção fornecido. Exemplo: 05:00. corda
expirationDateTime Data de validade efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. A data de validade deve ser definida como uma data futura. Se não for fornecido, ele será definido como o datetime máximo 9999-12-31 23:59:59. corda
recurEvery Taxa na qual espera-se que uma janela de manutenção se repita. A taxa pode ser expressa como agendas diárias, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Os agendamentos mensais são formatados como [Frequência como inteiro]['Mês(s)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(s)'] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana De Segunda a Domingo] [Deslocamento Opcional(Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6 inclusive. Exemplos de agenda mensal são 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. corda
startDateTime Data de início efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A data de início pode ser definida como a data atual ou a data futura. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. corda
Fuso horário Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Horário Padrão do Pacífico, UTC, Horário Padrão da Europa, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. corda

Microsoft.Maintenance/maintenanceConfigurations

Nome Descrição Valor
localização Obtém ou define o local do recurso corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Obtém ou define as propriedades do recurso MaintenanceConfigurationProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

Definição de recurso de modelo do ARM

O tipo de recurso maintenanceConfigurations pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Maintenance/maintenanceConfigurations, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Maintenance/maintenanceConfigurations",
  "apiVersion": "2023-04-01",
  "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 propriedade

InputLinuxParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
packageNameMasksToExclude Nomes de pacote a serem excluídos para aplicação de patch. string[]
packageNameMasksToInclude Nomes de pacote a serem incluídos para aplicação de patch. string[]

InputPatchConfiguration

Nome Descrição Valor
linuxParameters Parâmetros de entrada específicos para a aplicação de patch do computador Linux. Para computadores Windows, não passe essa propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinicialização, conforme definido pelo usuário com base no qual ele seria decidido reinicializar o computador ou não depois que a operação de patch for concluída. 'Always'
'IfRequired'
'Nunca'
windowsParameters Parâmetros de entrada específicos para aplicação de patch em um computador Windows. Para computadores Linux, não passe essa propriedade. InputWindowsParameters

InputWindowsParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
excludeKbsRequiringReboot Excluir patches que precisam ser reinicializados Bool
kbNumbersToExclude O KBID do Windows a ser excluído para aplicação de patch. string[]
kbNumbersToInclude O KBID do Windows a ser incluído para aplicação de patch. string[]

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da maintenanceConfiguration MaintenanceConfigurationPropertiesExtensionProperties
installPatches Os parâmetros de entrada a serem passados para a operação de execução de patch. InputPatchConfiguration
maintenanceScope Obtém ou define maintenanceScope da configuração 'Extensão'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definição de um MaintenanceWindow MaintenanceWindow
Namespace Obtém ou define o namespace do recurso corda
visibilidade Obtém ou define a visibilidade da configuração. O valor padrão é 'Personalizado' 'Personalizado'
'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nome Descrição Valor

MaintenanceConfigurationTags

Nome Descrição Valor

MaintenanceWindow

Nome Descrição Valor
duração Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor padrão será usado com base no escopo de manutenção fornecido. Exemplo: 05:00. corda
expirationDateTime Data de validade efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. A data de validade deve ser definida como uma data futura. Se não for fornecido, ele será definido como o datetime máximo 9999-12-31 23:59:59. corda
recurEvery Taxa na qual espera-se que uma janela de manutenção se repita. A taxa pode ser expressa como agendas diárias, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Os agendamentos mensais são formatados como [Frequência como inteiro]['Mês(s)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(s)'] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana De Segunda a Domingo] [Deslocamento Opcional(Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6 inclusive. Exemplos de agenda mensal são 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. corda
startDateTime Data de início efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A data de início pode ser definida como a data atual ou a data futura. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. corda
Fuso horário Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Horário Padrão do Pacífico, UTC, Horário Padrão da Europa, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. corda

Microsoft.Maintenance/maintenanceConfigurations

Nome Descrição Valor
apiVersion A versão da API '2023-04-01'
localização Obtém ou define o local do recurso corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Obtém ou define as propriedades do recurso MaintenanceConfigurationProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Maintenance/maintenanceConfigurations'

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso maintenanceConfigurations pode ser implantado com operações de destino:

  • grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Maintenance/maintenanceConfigurations, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
  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 propriedade

InputLinuxParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
packageNameMasksToExclude Nomes de pacote a serem excluídos para aplicação de patch. string[]
packageNameMasksToInclude Nomes de pacote a serem incluídos para aplicação de patch. string[]

InputPatchConfiguration

Nome Descrição Valor
linuxParameters Parâmetros de entrada específicos para a aplicação de patch do computador Linux. Para computadores Windows, não passe essa propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinicialização, conforme definido pelo usuário com base no qual ele seria decidido reinicializar o computador ou não depois que a operação de patch for concluída. 'Always'
'IfRequired'
'Nunca'
windowsParameters Parâmetros de entrada específicos para aplicação de patch em um computador Windows. Para computadores Linux, não passe essa propriedade. InputWindowsParameters

InputWindowsParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a serem corrigidos string[]
excludeKbsRequiringReboot Excluir patches que precisam ser reinicializados Bool
kbNumbersToExclude O KBID do Windows a ser excluído para aplicação de patch. string[]
kbNumbersToInclude O KBID do Windows a ser incluído para aplicação de patch. string[]

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da maintenanceConfiguration MaintenanceConfigurationPropertiesExtensionProperties
installPatches Os parâmetros de entrada a serem passados para a operação de execução de patch. InputPatchConfiguration
maintenanceScope Obtém ou define maintenanceScope da configuração 'Extensão'
'Host'
'InGuestPatch'
'OSImage'
'Resource'
'SQLDB'
'SQLManagedInstance'
maintenanceWindow Definição de um MaintenanceWindow MaintenanceWindow
Namespace Obtém ou define o namespace do recurso corda
visibilidade Obtém ou define a visibilidade da configuração. O valor padrão é 'Personalizado' 'Personalizado'
'Público'

MaintenanceConfigurationPropertiesExtensionProperties

Nome Descrição Valor

MaintenanceConfigurationTags

Nome Descrição Valor

MaintenanceWindow

Nome Descrição Valor
duração Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor padrão será usado com base no escopo de manutenção fornecido. Exemplo: 05:00. corda
expirationDateTime Data de validade efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. A data de validade deve ser definida como uma data futura. Se não for fornecido, ele será definido como o datetime máximo 9999-12-31 23:59:59. corda
recurEvery Taxa na qual espera-se que uma janela de manutenção se repita. A taxa pode ser expressa como agendas diárias, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias da semana de segunda a domingo]. Exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Os agendamentos mensais são formatados como [Frequência como inteiro]['Mês(s)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(s)'] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana De Segunda a Domingo] [Deslocamento Opcional(Não. de dias)]. O valor de deslocamento deve estar entre -6 e 6 inclusive. Exemplos de agenda mensal são 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. corda
startDateTime Data de início efetiva da janela de manutenção no formato YYYY-MM-DD hh:mm. A data de início pode ser definida como a data atual ou a data futura. A janela será criada no fuso horário fornecido e ajustada para o horário de verão de acordo com esse fuso horário. corda
Fuso horário Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Horário Padrão do Pacífico, UTC, Horário Padrão da Europa, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. corda

Microsoft.Maintenance/maintenanceConfigurations

Nome Descrição Valor
localização Obtém ou define o local do recurso corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Obtém ou define as propriedades do recurso MaintenanceConfigurationProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"