Set-AzVMPlan
Define as informações do plano do Marketplace em uma máquina virtual.
Sintaxe
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.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, 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-AzVMImageSku. 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-AzVMImagePublisher.
| 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-AzVM para obter um objeto de máquina virtual. Você pode usar o cmdlet New-AzVMConfig 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 |