New-AzureVM

  • Referenz
Modul:
Azure

Erstellt einen virtuellen Azure-Computer.

Hinweis

Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service 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-AzureVM
   -ServiceName <String>
   [-DeploymentLabel <String>]
   [-DeploymentName <String>]
   [-VNetName <String>]
   [-DnsSettings <DnsServer[]>]
   [-InternalLoadBalancerConfig <InternalLoadBalancerConfig>]
   -VMs <PersistentVM[]>
   [-WaitForBoot]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureVM
   -ServiceName <String>
   [-Location <String>]
   [-AffinityGroup <String>]
   [-ServiceLabel <String>]
   [-ReverseDnsFqdn <String>]
   [-ServiceDescription <String>]
   [-DeploymentLabel <String>]
   [-DeploymentName <String>]
   [-VNetName <String>]
   [-DnsSettings <DnsServer[]>]
   [-InternalLoadBalancerConfig <InternalLoadBalancerConfig>]
   -VMs <PersistentVM[]>
   [-WaitForBoot]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureVM fügt einem vorhandenen Azure-Dienst einen neuen virtuellen Computer hinzu, oder erstellt einen virtuellen Computer und Dienst im aktuellen Abonnement, wenn entweder der Standort oder die AffinityGroup angegeben ist.

Beispiele

Beispiel 1: Erstellen eines virtuellen Computers für eine Windows-Konfiguration

PS C:\> New-AzureVMConfig -Name "VirtualMachine07" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[4].ImageName | Add-AzureProvisioningConfig -Windows -Password $adminPassword -AdminUsername PsTestAdmin | New-AzureVM -ServiceName "ContosoService" -AffinityGroup "Contoso" -WaitForBoot

Dieser Befehl erstellt eine Bereitstellungskonfiguration basierend auf einer Konfiguration des virtuellen Computers für das Windows-Betriebssystem und verwendet sie zum Erstellen eines virtuellen Computers in einer bestimmten Affinitätsgruppe.

Beispiel 2: Erstellen eines virtuellen Computers für eine Linux-Konfiguration

PS C:\> New-AzureVMConfig -Name "SUSEVM02" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[7].ImageName | Add-AzureProvisioningConfig -Linux -LinuxUser "RootMain" -Password "password" -AdminUsername PsTestAdmin | New-AzureVM

Mit diesem Befehl wird eine Bereitstellungskonfiguration basierend auf einer Konfiguration eines virtuellen Computers für Linux erstellt und verwendet, um einen virtuellen Computer in einer bestimmten Affinitätsgruppe zu erstellen.

Beispiel 3: Erstellen eines virtuellen Computers und Hinzufügen eines Datenträgers

PS C:\> $Images = Get-AzureVMImage
PS C:\> $Image = $Images[4]
PS C:\> $VirtualMachine02 = New-AzureVMConfig -Name "VirtualMachine02" -InstanceSize ExtraSmall -ImageName $myImage.ImageName | Add-AzureProvisioningConfig -Windows -Password "password" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "DataDisk50" -LUN 0

Die ersten beiden Befehle erhalten verfügbare Bilder mithilfe des Cmdlets "Get-AzureVMImage " und speichern einen davon in der $Image Variablen.

Dieser Befehl erstellt eine Bereitstellungskonfiguration basierend auf einer Konfiguration virtueller Computer für das Windows-Betriebssystem und verwendet sie zum Erstellen eines virtuellen Computers mit einem Azure-Datenträger.

Beispiel 4: Erstellen eines virtuellen Computers mit einer reservierten IP-Adresse

PS C:\> New-AzureVMConfig -Name "VirtualMachine06" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[4].ImageName | Add-AzureProvisioningConfig -Windows -Password $adminPassword -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService02" -AffinityGroup "Contoso" -ReservedIPName $ipName

Dieser Befehl erstellt eine Bereitstellungskonfiguration basierend auf einer Konfiguration eines virtuellen Computers für das Windows-Betriebssystem und verwendet sie zum Erstellen eines virtuellen Computers mit einer reservierten IP-Adresse.

Parameter

-AffinityGroup

Gibt die Azure-Affinitätsgruppe an, in der sich der Clouddienst befindet. Dieser Parameter ist nur erforderlich, wenn dieses Cmdlet einen Clouddienst erstellt.

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

-DeploymentLabel

Gibt eine Bezeichnung für die Bereitstellung an.

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

-DeploymentName

Gibt einen Bereitstellungsnamen an. Wenn nicht angegeben, verwendet dieses Cmdlet den Dienstnamen als Bereitstellungsnamen.

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

-DnsSettings

Gibt ein DNS-Serverobjekt an, das die DNS-Einstellungen für die neue Bereitstellung definiert.

Typ:DnsServer[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Weiter
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

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

-InternalLoadBalancerConfig

Gibt einen internen Lastenausgleich an. Dieser Parameter wird nicht verwendet.

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

-Location

Gibt den Speicherort an, an dem der neue Dienst gehostet wird. Wenn der Dienst bereits vorhanden ist, geben Sie diesen Parameter nicht an.

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

-ReservedIPName

Gibt den Namen der reservierten IP-Adresse an.

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

-ReverseDnsFqdn

Gibt den vollqualifizierten Domänennamen für reverse DNS an.

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

-ServiceDescription

Gibt eine Beschreibung für den neuen Dienst an.

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

-ServiceLabel

Gibt eine Bezeichnung für den neuen Dienst an.

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

-ServiceName

Gibt den neuen oder vorhandenen Dienstnamen an.

Wenn der Dienst nicht vorhanden ist, erstellt es dieses Cmdlet für Sie. Verwenden Sie den Parameter Location oder AffinityGroup , um anzugeben, wo der Dienst erstellt werden soll.

Wenn der Dienst vorhanden ist, ist der Parameter "Location " oder "AffinityGroup " nicht erforderlich.

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

-VMs

Gibt eine Liste der zu erstellenden Objekte des virtuellen Computers an.

Typ:PersistentVM[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VNetName

Gibt den Namen des virtuellen Netzwerks an, in dem dieses Cmdlet den virtuellen Computer bereitstellt.

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

-WaitForBoot

Gibt an, dass dieses Cmdlet auf den virtuellen Computer wartet, um den ReadyRole-Zustand zu erreichen. Dieses Cmdlet schlägt fehl, wenn der virtuelle Computer beim Warten in einen der folgenden Zustände fällt: FailedStartingVM, ProvisioningFailed, ProvisioningTimeout.

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