Microsoft.VirtualMachineImages imageTemplates 2019-02-01-preview

Artykuł
12/17/2024

Definicja zasobu Bicep

Typ zasobu imageTemplates można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.VirtualMachineImages/imageTemplates, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Obiekty ImageTemplateCustomizer

Ustaw właściwość , aby określić typ obiektu.

W przypadku programu PowerShellużyj:

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'PowerShell'
  validExitCodes: [
    int
  ]
}

W przypadku usługi Shellużyj:

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'Shell'
}

W przypadku WindowsRestart użyj:

{
  restartCheckCommand: 'string'
  restartCommand: 'string'
  restartTimeout: 'string'
  type: 'WindowsRestart'
}

Obiekty ImageTemplateSource

Ustaw właściwość , aby określić typ obiektu.

W przypadku ISO użyj:

{
  sha256Checksum: 'string'
  sourceURI: 'string'
  type: 'ISO'
}

W przypadku ManagedImageużyj:

{
  imageId: 'string'
  type: 'ManagedImage'
}

W przypadku PlatformImageużyj:

{
  offer: 'string'
  publisher: 'string'
  sku: 'string'
  type: 'PlatformImage'
  version: 'string'
}

Obiekty ImageTemplateDistributor

Ustaw właściwość , aby określić typ obiektu.

W przypadku ManagedImageużyj:

{
  imageId: 'string'
  location: 'string'
  type: 'ManagedImage'
}

W przypadku SharedImageużyj:

{
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  type: 'SharedImage'
}

W przypadkuwirtualnego dysku twardego użyj:

{
  type: 'VHD'
}

Wartości właściwości

ImageTemplateCustomizer

Nazwa	Opis	Wartość
nazwa	Przyjazna nazwa, aby podać kontekst tego kroku dostosowywania	struna
typ	Ustaw wartość "PowerShell" dla typu ImageTemplatePowerShellCustomizer. Ustaw wartość "Shell" dla typu ImageTemplateShellCustomizer. Ustaw wartość "WindowsRestart" dla typu ImageTemplateRestartCustomizer.	"PowerShell" "Powłoka" "WindowsRestart" (wymagany)

ImageTemplateDistributor

Nazwa	Opis	Wartość
artifactTags	Tagi, które zostaną zastosowane do artefaktu po jego utworzeniu/zaktualizowaniu przez dystrybutora.	ImageTemplateDistributorArtifactTags
runOutputName	Nazwa, która ma być używana dla skojarzonego elementu RunOutput.	struna Ograniczenia: Wzorzec = `^[A-Za-z0-9-_]{1,64}$` (wymagane)
typ	Ustaw wartość "ManagedImage" dla typu ImageTemplateManagedImageDistributor. Ustaw wartość "SharedImage" dla typu ImageTemplateSharedImageDistributor. Ustaw wartość "VHD" dla typu ImageTemplateVhdDistributor.	"ManagedImage" "SharedImage" "VHD" (wymagany)

ImageTemplateDistributorArtifactTags

Nazwa	Opis	Wartość

ImageTemplateIsoSource

Nazwa	Opis	Wartość
sha256Checksum	Sha256 Suma kontrolna obrazu ISO.	ciąg (wymagany)
sourceURI	Identyfikator URI umożliwiający pobranie obrazu ISO. Ten identyfikator URI musi być dostępny dla dostawcy zasobów podczas tworzenia szablonu obrazu.	ciąg (wymagany)
typ	Określa typ obrazu źródłowego, z którym chcesz zacząć.	"ISO" (wymagane)

ImageTemplateManagedImageDistributor

Nazwa	Opis	Wartość
imageId	Identyfikator zasobu obrazu dysku zarządzanego	ciąg (wymagany)
lokalizacja	Lokalizacja platformy Azure dla obrazu powinna być zgodna z tym, czy obraz już istnieje	ciąg (wymagany)
typ	Typ rozkładu.	"ManagedImage" (wymagane)

ImageTemplateManagedImageSource

Nazwa	Opis	Wartość
imageId	Identyfikator zasobu usługi ARM obrazu zarządzanego w subskrypcji klienta	ciąg (wymagany)
typ	Określa typ obrazu źródłowego, z którym chcesz zacząć.	"ManagedImage" (wymagane)

ImageTemplatePlatformImageSource

Nazwa	Opis	Wartość
oferta	Oferta obrazu z Azure Gallery Images.	struna
wydawca	Program Image Publisher w usłudze Azure Gallery Images.	struna
Numer jednostki magazynowej	Jednostka SKU obrazu z Obrazów z galerii platformy Azure.	struna
typ	Określa typ obrazu źródłowego, z którym chcesz zacząć.	"PlatformImage" (wymagane)
Wersja	Wersja obrazu z Obrazów z galerii platformy Azure.	struna

ImageTemplatePowerShellCustomizer

Nazwa	Opis	Wartość
Wbudowany	Tablica poleceń programu PowerShell do wykonania	string[]
skrypt	Skrypt programu PowerShell do uruchomienia na potrzeby dostosowywania. Może to być link github, identyfikator URI sygnatury dostępu współdzielonego dla usługi Azure Storage itp.	struna
typ	Typ narzędzia dostosowywania, którego chcesz użyć na obrazie. Na przykład "Powłoka" może być konfiguratorem powłoki	"PowerShell" (wymagany)
validExitCodes	Prawidłowe kody zakończenia skryptu programu PowerShell. [Wartość domyślna: 0]	int[]

ImageTemplateProperties

Nazwa	Opis	Wartość
Dostosuj	Określa właściwości używane do opisywania kroków dostosowywania obrazu, takich jak źródło obrazu itp.	ImageTemplateCustomizer[]
rozdzielać	Lokalizacja docelowa dystrybucji, do której należy przejść dane wyjściowe obrazu.	ImageTemplateDistributor[] (wymagane)
źródło	Określa właściwości używane do opisywania obrazu źródłowego.	ImageTemplateSource (wymagane)

ImageTemplateRestartCustomizer

Nazwa	Opis	Wartość
restartCheckCommand	Polecenie sprawdzania, czy ponowne uruchomienie zakończyło się pomyślnie [Ustawienie domyślne: ""]	struna
restartCommand	Polecenie do wykonania ponownego uruchomienia [Domyślne: "shutdown /r /f /t 0 /c "packer restart"]	struna
restartTimeout	Limit czasu ponownego uruchamiania określony jako ciąg wielkości i jednostki, np. "5m" (5 minut) lub "2h" (2 godziny) [Wartość domyślna: "5m"]	struna
typ	Typ narzędzia dostosowywania, którego chcesz użyć na obrazie. Na przykład "Powłoka" może być konfiguratorem powłoki	"WindowsRestart" (wymagany)

ImageTemplateSharedImageDistributor

Nazwa	Opis	Wartość
galleryImageId	Identyfikator zasobu obrazu galerii obrazów udostępnionych	ciąg (wymagany)
replicationRegions		string[] (wymagane)
typ	Typ rozkładu.	"SharedImage" (wymagane)

ImageTemplateShellCustomizer

Nazwa	Opis	Wartość
Wbudowany	Tablica poleceń powłoki do wykonania	string[]
skrypt	Skrypt powłoki do uruchomienia na potrzeby dostosowywania. Może to być link github, identyfikator URI sygnatury dostępu współdzielonego dla usługi Azure Storage itp.	struna
typ	Typ narzędzia dostosowywania, którego chcesz użyć na obrazie. Na przykład "Powłoka" może być konfiguratorem powłoki	"Shell" (wymagane)

ImageTemplateSource

Nazwa	Opis	Wartość
typ	Ustaw wartość "ISO" dla typu ImageTemplateIsoSource. Ustaw wartość "ManagedImage" dla typu ImageTemplateManagedImageSource. Ustaw wartość "PlatformImage" dla typu ImageTemplatePlatformImageSource.	"ISO" "ManagedImage" "PlatformImage" (wymagane)

ImageTemplateVhdDistributor

Nazwa	Opis	Wartość
typ	Typ rozkładu.	"VHD" (wymagany)