New-AzStackHCIVMImage

Modulo:

Az.StackHCIVM Module

Operazione per creare un'immagine. Si noti che alcune proprietà possono essere impostate solo durante la creazione dell'immagine.

Sintassi

MarketplaceURN (Impostazione predefinita)

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

GalleryImage

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

Marketplace

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

Descrizione

Operazione per creare un'immagine. Si noti che alcune proprietà possono essere impostate solo durante la creazione dell'immagine.

Esempio

Esempio 1: Creare un'immagine della raccolta

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

Questo comando crea un'immagine della raccolta da un percorso locale.

Esempio 2: Creare un'immagine della raccolta marketplace

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

Questo comando crea un'immagine della raccolta del Marketplace usando l'offerta , l'editore, lo SKU e la versione specificati.

Esempio 3: {Creare un'immagine della raccolta del Marketplace da 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

Questo comando crea un'immagine della raccolta del Marketplace usando l'urn specificato.

Parametri

-AsJob

Eseguire il comando come processo

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-CloudInitDataSource

Origine dati per l'immagine della raccolta durante il provisioning con cloud-init [NoCloud, Azure]

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Cfr

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-CustomLocationId

ID ARM della posizione estesa in cui creare una risorsa immagine.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Proprietà dei parametri

Tipo:	PSObject
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	AzureRMContext, AzureCredential

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ImagePath

Percorso locale dell'immagine da cui deve essere creata l'immagine.

Questo parametro è obbligatorio per le immagini non del Marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

GalleryImage

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Location

Posizione geografica in cui risiede la risorsa

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Name

Nome dell'immagine Il nome deve iniziare e terminare con un carattere alfanumerico e deve contenere tutti i caratteri alfanumerici o '-', '.' o '_'. La lunghezza massima può essere di 80 caratteri e la lunghezza minima è 1 carattere.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	ImageName

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-NoWait

Eseguire il comando in modo asincrono

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Offer

Nome dell'offerta di definizione dell'immagine della raccolta del marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Marketplace

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-OSType

Tipo di sistema operativo usato dall'immagine della raccolta [Windows, Linux]

Proprietà dei parametri

Tipo:	Object
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Publisher

Nome dell'autore delle definizioni di immagini della raccolta del marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Marketplace

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ResourceGroupName

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Sku

Nome dello SKU di definizione dell'immagine della raccolta del marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Marketplace

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StoragePathId

Storage ContainerID del contenitore di archiviazione da usare per l'immagine della raccolta

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StoragePathName

Nome del contenitore di archiviazione da usare per l'immagine della raccolta

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-StoragePathResourceGroup

Gruppo di risorse del percorso di archiviazione. Il valore predefinito è il gruppo di risorse dell'immagine.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-SubscriptionId

ID della sottoscrizione di destinazione.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	(Get-AzContext).Subscription.Id
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Tag

Tag di risorsa.

Proprietà dei parametri

Tipo:	Hashtable
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-URN

URN dell'immagine della raccolta del marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

MarketplaceURN

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Version

Versione dell'immagine della raccolta del Marketplace.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

Marketplace

Posizione:	Named
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Wi

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

IGalleryImages

IMarketplaceGalleryImages