Microsoft.Maintenance maintenanceConfigurations

Artigo
12/20/2024

Definição de recursos do bíceps

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

Grupos de recursos - Consulte comandos de implantação de grupo de recursos

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

Formato do recurso

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

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 propriedade

InputLinuxParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
packageNameMasksToExclude	Nomes de pacotes a serem excluídos para aplicação de patches.	string[]
packageNameMasksToInclude	Nomes de pacotes a serem incluídos para aplicação de patches.	string[]

InputPatchConfiguration

Designação	Descrição	Valor
linuxParâmetros	Parâmetros de entrada específicos para a aplicação de patches na máquina Linux. Para máquinas Windows, não passe esta propriedade.	InputLinuxParameters
rebootSetting	Possível preferência de reinicialização, conforme definido pelo usuário, com base no qual seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.	'Sempre' 'SeNecessário' 'Nunca'
windowsParameters	Parâmetros de entrada específicos para aplicar patches em uma máquina Windows. Para máquinas Linux, não passe esta propriedade.	InputWindowsParameters

InputWindowsParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
excludeKbsRequiringReboot	Excluir patches que precisam ser reinicializados	Bool
kbNumbersToExclude	Windows KBID a ser excluído para aplicação de patches.	string[]
kbNumbersToInclude	Windows KBID a ser incluído para aplicação de patches.	string[]

ManutençãoConfiguraçãoPropriedades

Designação	Descrição	Valor
extensãoPropriedades	Obtém ou define extensionProperties of the maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Os parâmetros de entrada a serem passados para a operação de execução do patch.	InputPatchConfiguration
manutençãoÂmbito	Obtém ou define manutençãoEscopo da configuração	'Extensão' 'Anfitrião' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
manutençãoJanela	Definição de uma MaintenanceWindow	MaintenanceWindow
espaço de nomes	Obtém ou define o namespace do recurso	string
Visibilidade	Obtém ou define a visibilidade da configuração. O valor padrão é 'Custom'	'Personalizado' 'Público'

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

Designação	Descrição	Valor

MaintenanceConfigurationTags

Designação	Descrição	Valor

Janela de Manutenção

Designação	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.	string
expiraçãoDataHora	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 ao horário de verão de acordo com esse fuso horário. A data de expiração deve ser definida para uma data futura. Se não for fornecido, será definido para a data/hora máxima 9999-12-31 23:59:59.	string
recorrência	Taxa na qual se espera que uma janela de Manutenção se repita. A taxa pode ser expressa em horários diários, semanais ou mensais. A programação diária é formatada como recorrente: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de horários diários são recorrentes: Dia, recorrentes: 3Dias. A programação semanal é formatada como recorrente: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias úteis de segunda a domingo]. Exemplos de programação semanal são recorrentes: 3Weeks, recurEvery: Semana sábado, domingo. As agendas mensais são formatadas como [Frequência como inteiro]['Mês(es)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(es)'] [Semana do Mês (Primeiro, Segundo, Terceira, Quarta, Última, Última)] [Dia da Semana de Segunda a Domingo] [Compensação Opcional(Nº de dias)]. O valor de deslocamento deve estar entre -6 a 6, inclusive. Exemplos de programação mensal são recorrentesEvery: 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 ao horário de verão de acordo com esse fuso horário.	string
Fuso horário	Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, Hora Padrão da Europa W., Hora Padrão da Coreia, Cen. Hora Padrão da Austrália.	string

Microsoft.Manutenção/manutençãoConfigurações

Designação	Descrição	Valor
Localização	Obtém ou define a localização do recurso	string
Designação	O nome do recurso	string (obrigatório)
propriedades	Obtém ou define propriedades do recurso	MaintenanceConfigurationProperties
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos

Definição de recurso de modelo ARM

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

Grupos de recursos - Consulte comandos de implantação de grupo de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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-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 propriedade

InputLinuxParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
packageNameMasksToExclude	Nomes de pacotes a serem excluídos para aplicação de patches.	string[]
packageNameMasksToInclude	Nomes de pacotes a serem incluídos para aplicação de patches.	string[]

InputPatchConfiguration

Designação	Descrição	Valor
linuxParâmetros	Parâmetros de entrada específicos para a aplicação de patches na máquina Linux. Para máquinas Windows, não passe esta propriedade.	InputLinuxParameters
rebootSetting	Possível preferência de reinicialização, conforme definido pelo usuário, com base no qual seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.	'Sempre' 'SeNecessário' 'Nunca'
windowsParameters	Parâmetros de entrada específicos para aplicar patches em uma máquina Windows. Para máquinas Linux, não passe esta propriedade.	InputWindowsParameters

InputWindowsParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
excludeKbsRequiringReboot	Excluir patches que precisam ser reinicializados	Bool
kbNumbersToExclude	Windows KBID a ser excluído para aplicação de patches.	string[]
kbNumbersToInclude	Windows KBID a ser incluído para aplicação de patches.	string[]

ManutençãoConfiguraçãoPropriedades

Designação	Descrição	Valor
extensãoPropriedades	Obtém ou define extensionProperties of the maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Os parâmetros de entrada a serem passados para a operação de execução do patch.	InputPatchConfiguration
manutençãoÂmbito	Obtém ou define manutençãoEscopo da configuração	'Extensão' 'Anfitrião' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
manutençãoJanela	Definição de uma MaintenanceWindow	MaintenanceWindow
espaço de nomes	Obtém ou define o namespace do recurso	string
Visibilidade	Obtém ou define a visibilidade da configuração. O valor padrão é 'Custom'	'Personalizado' 'Público'

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

Designação	Descrição	Valor

MaintenanceConfigurationTags

Designação	Descrição	Valor

Janela de Manutenção

Designação	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.	string
expiraçãoDataHora	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 ao horário de verão de acordo com esse fuso horário. A data de expiração deve ser definida para uma data futura. Se não for fornecido, será definido para a data/hora máxima 9999-12-31 23:59:59.	string
recorrência	Taxa na qual se espera que uma janela de Manutenção se repita. A taxa pode ser expressa em horários diários, semanais ou mensais. A programação diária é formatada como recorrente: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de horários diários são recorrentes: Dia, recorrentes: 3Dias. A programação semanal é formatada como recorrente: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias úteis de segunda a domingo]. Exemplos de programação semanal são recorrentes: 3Weeks, recurEvery: Semana sábado, domingo. As agendas mensais são formatadas como [Frequência como inteiro]['Mês(es)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(es)'] [Semana do Mês (Primeiro, Segundo, Terceira, Quarta, Última, Última)] [Dia da Semana de Segunda a Domingo] [Compensação Opcional(Nº de dias)]. O valor de deslocamento deve estar entre -6 a 6, inclusive. Exemplos de programação mensal são recorrentesEvery: 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 ao horário de verão de acordo com esse fuso horário.	string
Fuso horário	Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, Hora Padrão da Europa W., Hora Padrão da Coreia, Cen. Hora Padrão da Austrália.	string

Microsoft.Manutenção/manutençãoConfigurações

Designação	Descrição	Valor
apiVersion	A versão api	'2023-10-01-pré-visualização'
Localização	Obtém ou define a localização do recurso	string
Designação	O nome do recurso	string (obrigatório)
propriedades	Obtém ou define propriedades do recurso	MaintenanceConfigurationProperties
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo	O tipo de recurso	'Microsoft.Maintenance/maintenanceConfigurations'

Definição de recursos Terraform (provedor AzAPI)

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

Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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-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 propriedade

InputLinuxParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
packageNameMasksToExclude	Nomes de pacotes a serem excluídos para aplicação de patches.	string[]
packageNameMasksToInclude	Nomes de pacotes a serem incluídos para aplicação de patches.	string[]

InputPatchConfiguration

Designação	Descrição	Valor
linuxParâmetros	Parâmetros de entrada específicos para a aplicação de patches na máquina Linux. Para máquinas Windows, não passe esta propriedade.	InputLinuxParameters
rebootSetting	Possível preferência de reinicialização, conforme definido pelo usuário, com base no qual seria decidido reiniciar a máquina ou não após a operação de patch ser concluída.	'Sempre' 'SeNecessário' 'Nunca'
windowsParameters	Parâmetros de entrada específicos para aplicar patches em uma máquina Windows. Para máquinas Linux, não passe esta propriedade.	InputWindowsParameters

InputWindowsParameters

Designação	Descrição	Valor
classificaçõesToInclude	Categoria de classificação dos sistemas a serem corrigidos	string[]
excludeKbsRequiringReboot	Excluir patches que precisam ser reinicializados	Bool
kbNumbersToExclude	Windows KBID a ser excluído para aplicação de patches.	string[]
kbNumbersToInclude	Windows KBID a ser incluído para aplicação de patches.	string[]

ManutençãoConfiguraçãoPropriedades

Designação	Descrição	Valor
extensãoPropriedades	Obtém ou define extensionProperties of the maintenanceConfiguration	MaintenanceConfigurationPropertiesExtensionProperties
installPatches	Os parâmetros de entrada a serem passados para a operação de execução do patch.	InputPatchConfiguration
manutençãoÂmbito	Obtém ou define manutençãoEscopo da configuração	'Extensão' 'Anfitrião' 'InGuestPatch' 'OSImage' 'Recurso' 'SQLDB' 'SQLManagedInstance'
manutençãoJanela	Definição de uma MaintenanceWindow	MaintenanceWindow
espaço de nomes	Obtém ou define o namespace do recurso	string
Visibilidade	Obtém ou define a visibilidade da configuração. O valor padrão é 'Custom'	'Personalizado' 'Público'

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

Designação	Descrição	Valor

MaintenanceConfigurationTags

Designação	Descrição	Valor

Janela de Manutenção

Designação	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.	string
expiraçãoDataHora	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 ao horário de verão de acordo com esse fuso horário. A data de expiração deve ser definida para uma data futura. Se não for fornecido, será definido para a data/hora máxima 9999-12-31 23:59:59.	string
recorrência	Taxa na qual se espera que uma janela de Manutenção se repita. A taxa pode ser expressa em horários diários, semanais ou mensais. A programação diária é formatada como recorrente: [Frequência como inteiro]['Dia(s)']. Se nenhuma frequência for fornecida, a frequência padrão será 1. Exemplos de horários diários são recorrentes: Dia, recorrentes: 3Dias. A programação semanal é formatada como recorrente: [Frequência como inteiro]['Semana(s)'] [Lista opcional separada por vírgulas dos dias úteis de segunda a domingo]. Exemplos de programação semanal são recorrentes: 3Weeks, recurEvery: Semana sábado, domingo. As agendas mensais são formatadas como [Frequência como inteiro]['Mês(es)'] [Lista separada por vírgulas de dias do mês] ou [Frequência como inteiro]['Mês(es)'] [Semana do Mês (Primeiro, Segundo, Terceira, Quarta, Última, Última)] [Dia da Semana de Segunda a Domingo] [Compensação Opcional(Nº de dias)]. O valor de deslocamento deve estar entre -6 a 6, inclusive. Exemplos de programação mensal são recorrentesEvery: 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 ao horário de verão de acordo com esse fuso horário.	string
Fuso horário	Nome do fuso horário. A lista de fusos horários pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Exemplo: Hora Padrão do Pacífico, UTC, Hora Padrão da Europa W., Hora Padrão da Coreia, Cen. Hora Padrão da Austrália.	string

Microsoft.Manutenção/manutençãoConfigurações

Designação	Descrição	Valor
Localização	Obtém ou define a localização do recurso	string
Designação	O nome do recurso	string (obrigatório)
propriedades	Obtém ou define propriedades do recurso	MaintenanceConfigurationProperties
Etiquetas	Tags de recursos	Dicionário de nomes e valores de tags.
tipo	O tipo de recurso	"Microsoft.Maintenance/maintenanceConfigurations@2023-10-01-preview"

Partilhar via

Microsoft.Maintenance maintenanceConfigurations

Definição de recursos do bíceps

Formato do recurso

Valores de propriedade

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

ManutençãoConfiguraçãoPropriedades

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

MaintenanceConfigurationTags

Janela de Manutenção

Microsoft.Manutenção/manutençãoConfigurações

Definição de recurso de modelo ARM

Formato do recurso

Valores de propriedade

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

ManutençãoConfiguraçãoPropriedades

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

MaintenanceConfigurationTags

Janela de Manutenção

Microsoft.Manutenção/manutençãoConfigurações

Definição de recursos Terraform (provedor AzAPI)

Formato do recurso

Valores de propriedade

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

ManutençãoConfiguraçãoPropriedades

ManutençãoConfiguraçãoPropriedadesExtensãoPropriedades

MaintenanceConfigurationTags

Janela de Manutenção

Microsoft.Manutenção/manutençãoConfigurações

Comentários

Recursos adicionais