Set-AzVMSourceImage
Especifica a imagem para uma máquina virtual.
Sintaxe
ImageReferenceSkuParameterSet (Predefiniçã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, em seguida, armazena-o 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 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 dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Id
Especifica a ID.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ImageReferenceIdParameterSet
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Offer
Especifica o tipo de oferta VMImage.
Para obter uma oferta de imagem, use o cmdlet Get-AzVMImageOffer.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ImageReferenceSkuParameterSet
Position: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-PublisherName
Especifica o nome de um editor de um VMImage.
Para obter um editor, use o cmdlet Get-AzVMImagePublisher.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ImageReferenceSkuParameterSet
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Skus
Especifica uma SKU VMImage.
Para obter SKUs, use o cmdlet Get-AzVMImageSku.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ImageReferenceSkuParameterSet
Position: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: 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 dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ImageReferenceSkuParameterSet
Position: 4 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-VM
Especifica o objeto de máquina virtual local a ser configurado.
Propriedades dos parâmetros
Tipo: PSVirtualMachine
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: VMProfile
Conjuntos de parâmetros
(All)
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: 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.
Saídas