Partilhar via

Manutenção Microsoft.MaintenanceConfigurations

  • Artigo

Definição de recurso do Bicep

O tipo de recurso maintenanceConfigurations pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Maintenance/maintenanceConfigurations, adicione o seguinte Bicep ao seu modelo.

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 propriedade

maintenanceConfigurations

Nome Descrição Valor
name O nome do recurso cadeia (obrigatório)
localização Obtém ou define a localização do recurso string
etiquetas Obtém ou define etiquetas do recurso Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades Obtém ou define propriedades do recurso MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da manutençãoConfiguração objeto
installPatches Os parâmetros de entrada a transmitir para a operação de execução de patches. InputPatchConfiguration
maintenanceScope Obtém ou define a manutençãoScope da configuração "Extensão"
'Anfitrião'
'InGuestPatch'
'OSImage'
"Recurso"
"SQLDB"
"SQLManagedInstance"
maintenanceWindow Definição de uma ManutençãoWindow MaintenanceWindow
espaço de nomes Obtém ou define o espaço de nomes do recurso string
visibilidade Obtém ou define a visibilidade da configuração. O valor predefinido é "Personalizado" "Personalizado"
"Público"

InputPatchConfiguration

Nome Descrição Valor
linuxParameters Parâmetros de entrada específicos da aplicação de patches do computador Linux. Para computadores Windows, não transmita esta propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinício, conforme definido pelo utilizador com base no qual seria decidido reiniciar o computador ou não após a conclusão da operação de patch. 'Sempre'
"IfRequired"
'Nunca'
windowsParameters Parâmetros de entrada específicos para a aplicação de patches de um computador Windows. Para computadores Linux, não transmita esta propriedade. InputWindowsParameters

InputLinuxParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a corrigir cadeia[]
packageNameMasksToExclude Nomes de pacotes a serem excluídos para a aplicação de patches. cadeia[]
packageNameMasksToInclude Nomes de pacotes a incluir para a aplicação de patches. cadeia[]

InputWindowsParameters

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

MaintenanceWindow

Nome Descrição Valor
duration Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor predefinido será utilizado com base no âmbito de manutenção fornecido. Exemplo: 05:00. string
expirationDateTime Data de expiração efetiva da janela de manutenção no formato AAAA-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada à hora de verão de acordo com esse fuso horário. A data de expiração tem de ser definida para uma data futura. Se não for fornecido, será definido como o datetime máximo 9999-12-31 23:59:59. string
recurEvery Taxa a que se espera que uma janela de Manutenção se repita. A taxa pode ser expressa como horários diários, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequency as integer]['Day(s)']. Se não for fornecida frequência, a frequência predefinida é 1. Os exemplos de agendamento diário são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays Monday-Sunday]. Os exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. As agendas mensais são formatadas como [Frequência como número inteiro]['Mês(s)]] [Lista separada por vírgulas de dias do mês] ou [Frequência como número inteiro]['Mês(s)][Semana(s)] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana de Segunda-feira a Domingo] [Deslocamento Opcional(Nº de dias)]. O valor de deslocamento tem de estar entre -6 e 6 inclusive. Os exemplos de agendamento 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. string
startDateTime Data de início efetiva da janela de manutenção no formato AAAA-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 à hora de verão de acordo com esse fuso horário. string
timeZone Nome do fuso horário. A lista de fusos horários pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, W. Europe Hora Padrão, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. string

Definição de recurso do modelo arm

O tipo de recurso maintenanceConfigurations pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Maintenance/maintenanceConfigurations, adicione o seguinte JSON ao seu modelo.

{
  "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 propriedade

maintenanceConfigurations

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Maintenance/maintenanceConfigurations"
apiVersion A versão da API de recursos '2023-04-01'
name O nome do recurso cadeia (obrigatório)
localização Obtém ou define a localização do recurso string
etiquetas Obtém ou define etiquetas do recurso Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
propriedades Obtém ou define as propriedades do recurso MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da maintenanceConfiguration objeto
installPatches Os parâmetros de entrada a serem transmitidos para a operação de execução de patch. InputPatchConfiguration
maintenanceScope Obtém ou define a manutençãoÂmbito da configuração "Extensão"
'Anfitrião'
'InGuestPatch'
'OSImage'
"Recurso"
"SQLDB"
"SQLManagedInstance"
maintenanceWindow Definição de uma MaintenanceWindow MaintenanceWindow
espaço de nomes Obtém ou define o espaço de nomes do recurso string
visibilidade Obtém ou define a visibilidade da configuração. O valor predefinido é "Personalizado" "Personalizado"
"Público"

InputPatchConfiguration

Nome Descrição Valor
LinuxParameters Parâmetros de entrada específicos da aplicação de patches do computador Linux. Para computadores Windows, não transmita esta propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinício, conforme definido pelo utilizador, com base no qual seria decidido reiniciar o computador ou não após a conclusão da operação de patch. "Sempre"
"IfRequired"
"Nunca"
windowsParameters Parâmetros de entrada específicos para aplicar patches a um computador Windows. Para computadores Linux, não transmita esta propriedade. InputWindowsParameters

InputLinuxParameters

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

InputWindowsParameters

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

MaintenanceWindow

Nome Descrição Valor
duration Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor predefinido será utilizado com base no âmbito de manutenção fornecido. Exemplo: 05:00. string
expirationDateTime Data de expiração efetiva da janela de manutenção no formato AAAA-MM-DD hh:mm. A janela será criada no fuso horário fornecido e ajustada à hora de verão de acordo com esse fuso horário. A data de expiração tem de ser definida para uma data futura. Se não for fornecido, será definido como o datetime máximo 9999-12-31 23:59:59. string
recurEvery Taxa a que se espera que uma janela de Manutenção se repita. A taxa pode ser expressa como horários diários, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequency as integer]['Day(s)']. Se não for fornecida frequência, a frequência predefinida é 1. Os exemplos de agendamento diário são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays Monday-Sunday]. Os exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. As agendas mensais são formatadas como [Frequência como número inteiro]['Mês(s)]] [Lista separada por vírgulas de dias do mês] ou [Frequência como número inteiro]['Mês(s)][Semana(s)] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana de Segunda-feira a Domingo] [Deslocamento Opcional(Nº de dias)]. O valor de deslocamento tem de estar entre -6 e 6 inclusive. Os exemplos de agendamento 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. string
startDateTime Data de início efetiva da janela de manutenção no formato AAAA-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 à hora de verão de acordo com esse fuso horário. string
timeZone Nome do fuso horário. A lista de fusos horários pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, W. Europe Hora Padrão, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. string

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso maintenanceConfigurations pode ser implementado com operações que visam:

  • Grupos de recursos

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

Formato do recurso

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

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 propriedade

maintenanceConfigurations

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Maintenance/maintenanceConfigurations@2023-04-01"
name O nome do recurso cadeia (obrigatório)
localização Obtém ou define a localização do recurso string
parent_id Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. cadeia (obrigatório)
etiquetas Obtém ou define etiquetas do recurso Dicionário de nomes e valores de etiquetas.
propriedades Obtém ou define propriedades do recurso MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

Nome Descrição Valor
extensionProperties Obtém ou define extensionProperties da manutençãoConfiguração objeto
installPatches Os parâmetros de entrada a transmitir para a operação de execução de patches. InputPatchConfiguration
maintenanceScope Obtém ou define a manutençãoScope da configuração "Extensão"
"Anfitrião"
"InGuestPatch"
"OSImage"
"Recurso"
"SQLDB"
"SQLManagedInstance"
maintenanceWindow Definição de uma ManutençãoWindow MaintenanceWindow
espaço de nomes Obtém ou define o espaço de nomes do recurso string
visibilidade Obtém ou define a visibilidade da configuração. O valor predefinido é "Personalizado" "Personalizado"
"Público"

InputPatchConfiguration

Nome Descrição Valor
linuxParameters Parâmetros de entrada específicos da aplicação de patches do computador Linux. Para computadores Windows, não transmita esta propriedade. InputLinuxParameters
rebootSetting Possível preferência de reinício, conforme definido pelo utilizador com base no qual seria decidido reiniciar o computador ou não após a conclusão da operação de patch. "Sempre"
"IfRequired"
"Nunca"
windowsParameters Parâmetros de entrada específicos para a aplicação de patches de um computador Windows. Para computadores Linux, não transmita esta propriedade. InputWindowsParameters

InputLinuxParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a corrigir cadeia[]
packageNameMasksToExclude Nomes de pacotes a serem excluídos para a aplicação de patches. cadeia[]
packageNameMasksToInclude Nomes de pacotes a incluir para a aplicação de patches. cadeia[]

InputWindowsParameters

Nome Descrição Valor
classificationsToInclude Categoria de classificação de patches a corrigir cadeia[]
excludeKbsRequiringReboot Excluir patches que precisam de ser reiniciados bool
kbNumbersToExclude KBID do Windows a ser excluído para a aplicação de patches. cadeia[]
kbNumbersToInclude KBID do Windows a ser incluído para a aplicação de patches. cadeia[]

MaintenanceWindow

Nome Descrição Valor
duration Duração da janela de manutenção no formato HH:mm. Se não for fornecido, o valor predefinido será utilizado com base no âmbito de manutenção fornecido. Exemplo: 05:00. string
expirationDateTime Data de expiração 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 a poupança de verão de acordo com esse fuso horário. A data de expiração tem de ser definida para uma data futura. Se não for fornecido, será definido como o datetime máximo 9999-12-31 23:59:59. string
recurEvery Taxa a que se espera que uma janela de Manutenção se repita. A taxa pode ser expressa como horários diários, semanais ou mensais. A agenda diária é formatada como recurEvery: [Frequency as integer]['Day(s)']. Se não for fornecida frequência, a frequência predefinida é 1. Os exemplos de agenda diária são recurEvery: Day, recurEvery: 3Days. A agenda semanal é formatada como recurEvery: [Frequency as integer]['Week(s)'] [Optional comma separated list of weekdays Monday-Sunday]. Os exemplos de agenda semanal são recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. As agendas mensais são formatadas como [Frequência como número inteiro]['Mês(s)]] [Lista separada por vírgulas dos dias do mês] ou [Frequência como número inteiro]['Mês(s)][Semana(s)] [Semana do Mês (Primeiro, Segundo, Terceiro, Quarto, Último)] [Dia da Semana segunda-feira a domingo] [Deslocamento Opcional(N.º de dias)]. O valor de deslocamento tem de estar entre -6 e 6 inclusive. Os exemplos de agendamento 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. string
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 a poupança de verão de acordo com esse fuso horário. string
timeZone Nome do fuso horário. A lista de fusos horários pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, W. Europe Standard Time, Hora Padrão da Coreia, Cen. Hora Padrão da Austrália. string