New-AzImageBuilderTemplateDistributorObject

Modul:

Az.ImageBuilder

Erstellen Sie ein Speicherobjekt für ImageTemplateDistributor.

Syntax

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

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

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

Beschreibung

Erstellen Sie ein Speicherobjekt für ImageTemplateDistributor.

Beispiele

Beispiel 1: Erstellen eines verwalteten Imageverteilers.

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.

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.

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.

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:	String
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.

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.

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