Freigeben über


New-AzStackHCIVMImage

Der Vorgang zum Erstellen eines Bilds. Beachten Sie, dass einige Eigenschaften nur während der Bilderstellung festgelegt werden können.

Syntax

New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   -URN <String>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   -ImagePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStackHCIVMImage
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OSType <Object>
   [-CloudInitDataSource <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-StoragePathId <String>]
   [-Tag <Hashtable>]
   -Offer <String>
   -Publisher <String>
   -Sku <String>
   -Version <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Der Vorgang zum Erstellen eines Bilds. Beachten Sie, dass einige Eigenschaften nur während der Bilderstellung festgelegt werden können.

Beispiele

Beispiel 1: Erstellen eines Katalogbilds

New-AzStackHCIVMImage -Name "testImage" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -ImagePath "C:\ClusterStorage\Volume1\Ubunut.vhdx" -OSType "Linux" -Location "eastus"

Name            ResourceGroupName
----            -----------------
testImage       test-rg

Mit diesem Befehl wird ein Katalogbild aus einem lokalen Pfad erstellt.

Beispiel 2: Erstellen eines Marketplace-Katalogbilds

New-AzStackHCIVMImage -Name "testMarketplaceImage" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus" -Offer "windowsserver" -Publisher "MicrosoftWindowsServer" -Sku "2022-Datacenter" -Version "latest" -OSType "Windows"

Name            ResourceGroupName
----            -----------------
testMarketplaceImage       test-rg

Mit diesem Befehl wird ein Marketplace-Katalogbild mit dem angegebenen Angebot , Herausgeber, Sku und Version erstellt.

Beispiel 3: {Erstellen eines Marketplace-Katalogbilds aus URN

New-AzStackHCIVMImage -Name "testMarketplaceImageURN" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus" -URN  "microsoftwindowsserver:windowsserver:2022-datacenter:latest" -OSType "Windows"

Name            ResourceGroupName
----            -----------------
testMarketplaceImageURN       test-rg

Mit diesem Befehl wird mithilfe des angegebenen Urns ein Marketplace-Katalogbild erstellt.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudInitDataSource

Datenquelle für das Katalogbild bei der Bereitstellung mit cloud-init [NoCloud, Azure]

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomLocationId

Die ARM-ID des erweiterten Speicherorts zum Erstellen einer Bildressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ImagePath

Lokaler Pfad des Bilds, aus dem das Bild erstellt werden soll.

Dieser Parameter ist für Nicht-Marketplace-Bilder erforderlich.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

Der geografische Standort, an dem sich die Ressource befindet

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Der Name des Bilds Der Name muss mit einem alphanumerischen Zeichen beginnen und enden und alle alphanumerischen Zeichen oder '-', '.' oder '_' enthalten. Die maximale Länge kann 80 Zeichen lang sein und die Mindestlänge beträgt 1 Zeichen.

Typ:String
Aliases:ImageName
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Offer

Der Name des Marketplae Gallery-Bilddefinitionsangebots.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-OSType

Betriebssystemtyp, den das Katalogimage verwendet [Windows, Linux]

Typ:Object
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Publisher

Der Name des Marketplace Gallery-Bilddefinitionsherausgebers.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Der Name der Bilddefinitions-SKU des Marketplace-Katalogs.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-StoragePathId

Storage ContainerID des Speichercontainers, der für das Katalogimage verwendet werden soll

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-StoragePathName

Speichercontainername des Speichercontainers, der für das Katalogimage verwendet werden soll

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-StoragePathResourceGroup

Ressourcengruppe des Speicherpfads. Der Standardwert ist die Ressourcengruppe des Bilds.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Ressourcentags.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-URN

Der URN des Marketplace-Katalogbilds.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Version

Die Version des Marketplace-Katalogbilds.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

IGalleryImages

IMarketplaceGalleryImages