Compartilhar via

Set-AzVMSourceImage

Módulo:
Az.Compute Module

Especifica a imagem de uma máquina virtual.

Sintaxe

ImageReferenceSkuParameterSet (Padrão) 

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-PublisherName] <String>
    [-Offer] <String>
    [-Skus] <String>
    [-Version] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ImageReferenceIdParameterSet 

Set-AzVMSourceImage
    [-VM] <PSVirtualMachine>
    [-Id] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Set-AzVMSourceImage especifica a imagem da plataforma a ser usada para uma máquina virtual.

Exemplos

Exemplo 1: Definir valores para uma imagem

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
Set-AzVMSourceImage -VM $VirtualMachine -PublisherName "MicrosoftWindowsServer" -Offer "WindowsServer" -Skus "2012-R2-Datacenter" -Version "latest"

O primeiro comando obtém o conjunto de disponibilidade chamado AvailabilitySet03 no grupo de recursos chamado ResourceGroup11 e, em seguida, armazena esse objeto na variável $AvailabilitySet. O segundo comando cria um objeto de máquina virtual e o armazena na variável $VirtualMachine. O comando atribui um nome e um tamanho à máquina virtual. A máquina virtual pertence ao conjunto de disponibilidade armazenado no $AvailabilitySet. O comando final define valores para o nome do editor, oferta, SKU e versão. Os cmdlets Get-AzVMImagePublisher, Get-AzVMImageOffer, Get-AzVMImageSku e Get-AzVMImage podem descobrir essas configurações.

Parâmetros

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

Especifica a ID.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImageReferenceIdParameterSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Offer

Especifica o tipo de oferta VMImage. Para obter uma oferta de imagem, use o cmdlet Get-AzVMImageOffer.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImageReferenceSkuParameterSet
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PublisherName

Especifica o nome de um editor de um VMImage. Para obter um editor, use o cmdlet Get-AzVMImagePublisher.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImageReferenceSkuParameterSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Skus

Especifica um SKU VMImage. Para obter SKUs, use o cmdlet Get-AzVMImageSku.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImageReferenceSkuParameterSet
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Version

Especifica uma versão de um VMImage. Para usar a versão mais recente, especifique um valor de latest em vez de uma versão específica.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImageReferenceSkuParameterSet
Cargo:4
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-VM

Especifica o objeto de máquina virtual local a ser configurado.

Propriedades do parâmetro

Tipo:PSVirtualMachine
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:VMProfile

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualMachine

String

Saídas

PSVirtualMachine