Freigeben über

New-WAPackVM

  • Referenz
Modul:
Azure

Erstellt einen virtuellen Computer.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

New-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-ProductKey <String>]
   [-Windows]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-Linux]
   [-AdministratorSSHKey <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   [-VNet <VMNetwork>]
   -OSDisk <VirtualHardDisk>
   -VMSizeProfile <HardwareProfile>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Beschreibung

Diese Themen sind veraltet und werden in Zukunft entfernt. In diesem Thema wird das Cmdlet in der Version 0.8.1 des Microsoft Azure PowerShell-Moduls beschrieben. Um die Version des verwendeten Moduls zu ermitteln, geben Sie in der Azure PowerShell-Konsole folgendes ein (Get-Module -Name Azure).Version.

Das Cmdlet New-WAPackVM erstellt einen virtuellen Computer.

Beispiele

Beispiel 1: Erstellen eines virtuellen Computers für das Windows-Betriebssystem mithilfe einer Vorlage

PS C:\> $Credentials = Get-Credential PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate04"PS C:\> New-WAPackVM -Name "ContosoV023" -Template $Template -VMCredential $Credentials -Windows

Der erste Befehl erstellt ein PSCredential-Objekt und speichert es dann in der $Credentials Variablen. Das Cmdlet fordert Sie auf, ein Konto und ein Kennwort einzugeben. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Der zweite Befehl ruft die Vorlage für virtuelle Computer mit dem Namen ContosoTemplate04 mithilfe des Cmdlets "Get-WAPackVMTemplate " ab und speichert sie dann in der $Template Variablen.

Der letzte Befehl erstellt einen virtuellen Computer namens ContosoV023, basierend auf der Vorlage, die in der variablen $Template gespeichert ist. Der Befehl gibt den Windows-Parameter an, und daher muss der virtuelle Computer eine Version des Windows-Betriebssystems ausführen.

Beispiel 2: Erstellen eines virtuellen Computers für das Linux-Betriebssystem mithilfe einer Vorlage

PS C:\> $Credentials = Get-Credential
PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate19"
PS C:\> New-WAPackVM -Linux -Name "ContosoV028" -Template $Template -VMCredential $Credentials

Der erste Befehl erstellt ein PSCredential-Objekt und speichert es dann in der $Credentials Variablen.

Der zweite Befehl ruft die Vorlage für virtuelle Computer mit dem Namen ContosoTemplate19 mithilfe des Cmdlets "Get-WAPackVMTemplate " ab und speichert sie dann in der variablen $Template.

Mit dem letzten Befehl wird ein virtueller Computer namens ContosoV028 erstellt, der auf der vorlage basiert, die in der variablen $Template gespeichert ist. Der Befehl gibt den Linux-Parameter an, und daher muss der virtuelle Computer eine Version des Linux-Betriebssystems ausführen.

Beispiel 3: Erstellen eines virtuellen Computers von einem Betriebssystemdatenträger und Größenprofil

PS C:\> $OSDisk = Get-WAPackVMOSDisk -Name "ContosoDiskOS"
PS C:\> $SizeProfile = Get-WAPackVMSizeProfile -Name "MediumSizeVM"
PS C:\> New-WAPackVM -Name "ContosoV073" -OSDisk $OSDisk -VMSizeProfile $SizeProfile

Der erste Befehl ruft einen Betriebssystemdatenträger mit dem Namen ContosoDiskOS mithilfe des Cmdlets "Get-WAPackVMOSDisk" ab und speichert ihn dann in der variablen $OSDisk.

Der zweite Befehl ruft das Größenprofil mit dem Namen "MediumSizeVM" mithilfe des Cmdlets "Get-WAPackVMSizeProfile " ab und speichert es dann in der $SizeProfile Variablen.

Der letzte Befehl erstellt einen virtuellen Computer namens "ContosoV073" aus dem Betriebssystemdatenträger, der in $OSDisk gespeichert ist, und das in $SizeProfile gespeicherte Größenprofil.

Parameter

-AdministratorSSHKey

Gibt den SSH-Schlüssel (Secure Shell) für das Administratorkonto an.

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

-Linux

Gibt an, dass das Cmdlet einen virtuellen Computer zum Ausführen des Linux-Betriebssystems erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für den virtuellen Computer an.

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

-OSDisk

Gibt einen Betriebssystemdatenträger als VirtualHardDisk -Objekt an. Verwenden Sie zum Abrufen eines Betriebssystemdatenträgers das Cmdlet Get-WAPackVMOSDisk .

Typ:VirtualHardDisk
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ProductKey

Gibt einen Product Key an. Der Product Key ist eine 25-stellige Nummer, die die Produktlizenz identifiziert. Verwenden Sie einen Product Key für ein Betriebssystem, das Sie auf einem virtuellen Computer oder Host installieren möchten.

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

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Template

Gibt eine Vorlage an. Das Cmdlet erstellt einen virtuellen Computer basierend auf der von Ihnen angegebenen Vorlage. Verwenden Sie zum Abrufen eines Vorlagenobjekts das Cmdlet Get-WAPackVMTemplate.

Typ:VMTemplate
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMCredential

Gibt die Anmeldeinformationen für das lokale Administratorkonto an. Verwenden Sie das Cmdlet Get-Credential, um ein PSCredential-Objekt abzurufen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMSizeProfile

Gibt ein Größenprofil für einen virtuellen Computer als HardwareProfile -Objekt an. Verwenden Sie zum Abrufen eines Größenprofils das Cmdlet Get-WAPackVMSizeProfile .

Typ:HardwareProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VNet

Gibt ein virtuelles Netzwerk an. Das Cmdlet verbindet den virtuellen Computer mit dem von Ihnen angegebenen virtuellen Netzwerk. Verwenden Sie zum Abrufen eines virtuellen Netzwerks das Cmdlet Get-WAPackVNet .

Typ:VMNetwork
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Windows

Gibt an, dass das Cmdlet einen virtuellen Computer zum Ausführen des Windows-Betriebssystems erstellt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False