Compartilhar via


Set-AzureRmVMPlan

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

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Set-AzureRmVMPlan 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.

Parâmetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Product

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

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PromotionCode

Especifica um código promocional.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Publisher

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

Tipo:String
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VM

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

Tipo:PSVirtualMachine
Aliases:VMProfile
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PSVirtualMachine

String

Saídas

PSVirtualMachine