New-AzImageBuilderTemplateDistributorObject

Modul:

Az.ImageBuilder

Erstellen Sie ein Speicherobjekt für ImageTemplateDistributor.

Syntax

PowerShell

New-AzImageBuilderTemplateDistributorObject
   -RunOutputName <String>
   [-ArtifactTag <IImageTemplateDistributorArtifactTags>]
   [-VhdDistributor]
   [-Uri <String>]
   [<CommonParameters>]

PowerShell

New-AzImageBuilderTemplateDistributorObject
   -RunOutputName <String>
   -ImageId <String>
   -Location <String>
   [-ManagedImageDistributor]
   [-ArtifactTag <IImageTemplateDistributorArtifactTags>]
   [<CommonParameters>]

PowerShell

New-AzImageBuilderTemplateDistributorObject
   -RunOutputName <String>
   [-ArtifactTag <IImageTemplateDistributorArtifactTags>]
   -GalleryImageId <String>
   [-SharedImageDistributor]
   [-ExcludeFromLatest <Boolean>]
   [-ReplicationRegion <String[]>]
   [-StorageAccountType <SharedImageStorageAccountType>]
   [-TargetRegion <ITargetRegion[]>]
   [-Versioning <IDistributeVersioner>]
   [<CommonParameters>]

Beschreibung

Erstellen Sie ein Speicherobjekt für ImageTemplateDistributor.

Beispiele

Beispiel 1: Erstellen eines verwalteten Imageverteilers.

PowerShell

New-AzImageBuilderTemplateDistributorObject -ManagedImageDistributor -ArtifactTag @{tag='azpstest'} -ImageId "/subscriptions/{subId}/resourceGroups/azps_test_group_imagebuilder/providers/Microsoft.Compute/images/azps-vm-image" -RunOutputName "runoutput-01" -Location eastus

RunOutputName ImageId                                                                                                             Location
------------- -------                                                                                                             --------
runoutput-01  /subscriptions/{subId}/resourceGroups/azps_test_group_imagebuilder/providers/Microsoft.Compute/images/azps-vm-image eastus

Mit diesem Befehl wird ein verwalteter Imageverteiler erstellt.

Beispiel 2: Erstellen eines VHD-Distributors.

PowerShell

New-AzImageBuilderTemplateDistributorObject -ArtifactTag @{tag='vhd'} -VhdDistributor -RunOutputName image-vhd

RunOutputName Uri
------------- ---
image-vhd

Mit diesem Befehl wird ein VHD-Verteiler erstellt.

Beispiel 3: Erstellen eines freigegebenen Bildverteilers.

PowerShell

New-AzImageBuilderTemplateDistributorObject -SharedImageDistributor -ArtifactTag @{"test"="dis-share"} -GalleryImageId "/subscriptions/{subId}/resourceGroups/azps_test_group_imagebuilder/providers/Microsoft.Compute/galleries/azpsazurecomputergallery/images/azps-vm-image" -ReplicationRegion "eastus" -RunOutputName "runoutput-01"

RunOutputName ExcludeFromLatest GalleryImageId                                                        ReplicationRegion StorageAccountType
------------- ----------------- --------------                                                        ----------------- -------
runoutput-01                    /subscriptions/{subId}/resourceGroups/azps_test_group_imagebuilder... {eastus}

Mit diesem Befehl wird ein freigegebener Bildverteiler erstellt.

Parameter

-ArtifactTag

Tags, die auf das Artefakt angewendet werden, nachdem es vom Verteiler erstellt/aktualisiert wurde. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für ARTIFACTTAG-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IImageTemplateDistributorArtifactTags
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ExcludeFromLatest

Flag, das angibt, ob die erstellte Bildversion von der neuesten Version ausgeschlossen werden soll. Lassen Sie die Standardeinstellung (false) weg.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-GalleryImageId

Ressourcen-ID des Azure Compute Gallery-Images.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ImageId

Ressourcen-ID des Verwalteten Datenträgerimages.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Location

Der Azure-Speicherort für das Bild sollte übereinstimmen, wenn das Bild bereits vorhanden ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ManagedImageDistributor

Als verwaltetes Datenträgerimage verteilen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ReplicationRegion

[Veraltet] Eine Liste der Regionen, in die das Bild repliziert wird. Diese Liste kann nur angegeben werden, wenn targetRegions nicht angegeben ist. Dieses Feld ist veraltet – verwenden Sie stattdessen targetRegions.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RunOutputName

Der Name, der für den zugeordneten RunOutput verwendet werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SharedImageDistributor

Verteilen über freigegebene Bildergalerie.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-StorageAccountType

[Veraltet] Speicherkontotyp, der zum Speichern des freigegebenen Images verwendet werden soll. Lassen Sie die Standardeinstellung aus (Standard_LRS). Dieses Feld kann nur angegeben werden, wenn "replicationRegions" angegeben ist. Dieses Feld ist veraltet – verwenden Sie stattdessen targetRegions.

Typ:	SharedImageStorageAccountType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TargetRegion

Die Zielbereiche, in denen die verteilte Imageversion repliziert werden soll. Dieses Objekt ersetzt replikationRegions und kann nur angegeben werden, wenn "replicationRegions" nicht angegeben ist. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für TARGETREGION-Eigenschaften und erstellen eine Hashtabelle.

Typ:	ITargetRegion[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Uri

Optionaler Azure Storage-URI für das verteilte VHD-Blob. Lassen Sie die Standardeinstellung (leere Zeichenfolge) aus, in diesem Fall würde VHD in dem Speicherkonto in der Stagingressourcengruppe veröffentlicht.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Versioning

Beschreibt, wie neue x.y.z-Versionsnummer für die Verteilung generiert wird. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für VERSIONSING-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IDistributeVersioner
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-VhdDistributor

Verteilen sie über VHD in einem Speicherkonto.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Ausgaben

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

ImageTemplateVhdDistributor