New-AzStackHCIVMImage

Referência

Módulo:: Az.StackHCIVM

A operação para criar uma imagem. Por favor, note que algumas propriedades podem ser definidas apenas durante a criação da imagem.

Sintaxe

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>]

Description

A operação para criar uma imagem. Por favor, note que algumas propriedades podem ser definidas apenas durante a criação da imagem.

Exemplos

Exemplo 1: Criar uma imagem da galeria

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

Este comando cria uma imagem de galeria a partir de um caminho local.

Exemplo 2: Criar uma imagem da Galeria do 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

Este comando cria uma imagem da galeria do marketplace usando a oferta, o editor, o sku e a versão especificados.

Exemplo 3: {Criar uma imagem da galeria do Marketplace a partir 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

Este comando cria uma imagem da galeria do marketplace usando a urna especificada.

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CloudInitDataSource

Fonte de dados para a imagem da galeria ao provisionar com cloud-init [NoCloud, Azure]

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CustomLocationId

O ID ARM do local estendido para criar o recurso de imagem.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ImagePath

Caminho local da imagem a partir da qual a imagem deve ser criada.

Este parâmetro é necessário para imagens que não sejam do mercado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Location

A geolocalização onde o recurso vive

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Nome da imagem O nome deve começar e terminar com um caractere alfanumérico e deve conter todos os caracteres alfanuméricos ou '-', '.', ou '_'. O comprimento máximo pode ser de 80 caracteres e o comprimento mínimo é de 1 caractere.

Tipo:	String
Aliases:	ImageName
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoWait

Execute o comando de forma assíncrona

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Offer

O nome da oferta de definição de imagem da galeria marketplae.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OSType

Tipo de sistema operacional que a imagem da galeria usa [Windows, Linux]

Tipo:	Object
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Publisher

O nome do editor de definição de imagem da galeria do marketplace.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Sku

O nome da definição de imagem da galeria do marketplace SKU.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StoragePathId

Contêiner de armazenamentoID do contêiner de armazenamento a ser usado para a imagem da galeria

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StoragePathName

Contêiner de armazenamento Nome do contêiner de armazenamento a ser usado para a imagem da galeria

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StoragePathResourceGroup

Grupo de recursos do caminho de armazenamento. O valor padrão é o grupo de recursos da imagem.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SubscriptionId

A ID da assinatura de destino.

Tipo:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Tag

Tags de recursos.

Tipo:	Hashtable
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-URN

A URN da imagem da galeria do mercado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Version

A versão da imagem da galeria do marketplace.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Saídas

IGalleryImages

IMarketplaceGalleryImages

Partilhar via