Set-AzVMPlan

  • Referência
Módulo:
Az.Compute

Define as informações do plano do Marketplace em uma máquina virtual.

Syntax

Set-AzVMPlan
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Product] <String>]
   [[-PromotionCode] <String>]
   [[-Publisher] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzVMPlan define as informações do plano do Azure Marketplace para uma máquina virtual. Antes de poder implantar uma imagem do Marketplace por meio da linha de comando, o acesso programático deve ser habilitado ou a máquina virtual deve ser implantada usando o portal do Azure.

Exemplos

Exemplo 1

New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_B1s" |
    Set-AzVMPlan -Publisher "Canonical" -Product "UbuntuServer" -Name "18.04-LTS"

Name            : VirtualMachine07
HardwareProfile : {VmSize}
Plan            : {Name, Publisher, Product}

Parâmetros

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome da imagem do Marketplace. Esse é o mesmo valor retornado pelo cmdlet Get-AzVMImageSku. Para obter mais informações sobre como localizar informações de imagem, consulte Localizar e usar imagens de VM do Azure Marketplace com o Azure PowerShell na documentação do Microsoft Azure.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Product

Especifica o produto da imagem do Marketplace. Essas são as mesmas informações que o valor Offer do elemento imageReference .

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PromotionCode

Especifica um código promocional.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Publisher

Especifica o editor da imagem. Você pode encontrar essas informações usando o cmdlet Get-AzVMImagePublisher.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Especifica o objeto de máquina virtual para o qual definir um plano do Marketplace. Você pode usar o cmdlet Get-AzVM para obter um objeto de máquina virtual. Você pode usar o cmdlet New-AzVMConfig para criar um objeto de máquina virtual.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSVirtualMachine

String

Saídas

PSVirtualMachine