Partilhar via

Set-AzVMPlan

Módulo:
Az.Compute Module

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

Sintaxe

Default (Predefinição) 

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

Description

O cmdlet Set-AzVMPlan define a informação do plano Azure Marketplace para uma máquina virtual. Antes de poder implementar uma imagem do Marketplace através da linha de comandos, o acesso programático deve estar ativado ou a máquina virtual deve ser implementada através do portal 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.

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

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Product

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PromotionCode

Especifica um código promocional.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Publisher

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:4
Obrigatório:False
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 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.

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.

Entradas

PSVirtualMachine

String

Saídas

PSVirtualMachine