Freigeben über


Set-AzVMPlan

Legt die Marketplace-Planinformationen auf einem virtuellen Computer fest.

Syntax

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

Beschreibung

Das Cmdlet Set-AzVMPlan legt die Azure Marketplace-Planinformationen für einen virtuellen Computer fest. Bevor Sie ein Marketplace-Image über die Befehlszeile bereitstellen können, muss der programmgesteuerte Zugriff aktiviert sein, oder der virtuelle Computer muss mithilfe der Azure-Portal bereitgestellt werden.

Beispiele

Beispiel 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}

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des Bilds aus dem Marketplace an. Dies ist derselbe Wert, der vom Cmdlet Get-AzVMImageSku zurückgegeben wird. Weitere Informationen zum Suchen von Bildinformationen finden Sie unter Suchen und Verwenden von Azure Marketplace-VM-Images mit Azure PowerShell in der Microsoft Azure-Dokumentation.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Product

Gibt das Produkt des Bilds vom Marketplace an. Dies sind die gleichen Informationen wie der Offer-Wert des imageReference-Elements .

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PromotionCode

Gibt einen Heraufsufungscode an.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Publisher

Gibt den Herausgeber des Bilds an. Sie finden diese Informationen mithilfe des Cmdlets "Get-AzVMImagePublisher".

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt das Objekt des virtuellen Computers an, für das ein Marketplace-Plan festgelegt werden soll. Sie können das Cmdlet Get-AzVM verwenden, um ein Objekt eines virtuellen Computers abzurufen. Sie können das Cmdlet New-AzVMConfig verwenden, um ein Objekt eines virtuellen Computers zu erstellen.

Typ:PSVirtualMachine
Aliase:VMProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PSVirtualMachine

String

Ausgaben

PSVirtualMachine