Freigeben über


New-AzureVMConfig

Erstellt ein Azure Virtual Machine-Konfigurationsobjekt.

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-AzureVMConfig
   [-Name] <String>
   [-InstanceSize] <String>
   [[-HostCaching] <String>]
   [[-AvailabilitySetName] <String>]
   [[-Label] <String>]
   [-ImageName] <String>
   [[-MediaLocation] <String>]
   [[-DiskLabel] <String>]
   [-DisableBootDiagnostics]
   [-LicenseType <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureVMConfig
   [-Name] <String>
   [-InstanceSize] <String>
   [[-HostCaching] <String>]
   [[-AvailabilitySetName] <String>]
   [[-Label] <String>]
   [-DiskName] <String>
   [-DisableBootDiagnostics]
   [-LicenseType <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureVMConfig erstellt ein Konfigurationsobjekt für virtuelle Azure-Computer. Sie können dieses Objekt verwenden, um eine neue Bereitstellung durchzuführen und einer vorhandenen Bereitstellung einen neuen virtuellen Computer hinzuzufügen.

Beispiele

Beispiel 1: Erstellen einer Konfiguration eines virtuellen Windows-Computers

PS C:\> $Image = (Get-AzureVMImage)[4].ImageName 
C:\PS> New-AzureVMConfig -Name "MyVM1" -InstanceSize ExtraSmall -ImageName $Image | Add-AzureProvisioningConfig -Windows -Password $AdminPassword | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "Datadisk1" -LUN 0 | New-AzureVM -ServiceName "MySvc1"

Mit diesem Befehl wird eine Konfiguration eines virtuellen Windows-Computers mit Betriebssystemdatenträger, Datenträger und Bereitstellungskonfiguration erstellt. Diese Konfiguration wird dann zum Erstellen eines neuen virtuellen Computers verwendet.

Beispiel 2: Erstellen einer Virtuellen Linux-Computerkonfiguration

PS C:\> $Image = (Get-AzureVMImage)[7].ImageName
C:\PS> New-AzureVMConfig -Name "MyVM1" -InstanceSize ExtraSmall -ImageName $Image | Add-AzureProvisioningConfig -Linux -LinuxUser $LinuxUser -Password $AdminPassword | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "Datadisk1" -LUN 0 | New-AzureVM -ServiceName "MySvc1"

Dieser Befehl erstellt eine neue virtuelle Linux-Computerkonfiguration mit Betriebssystemdatenträger, Datenträger und Bereitstellungskonfiguration. Diese Konfiguration wird dann zum Erstellen eines neuen virtuellen Computers verwendet.

Parameter

-AvailabilitySetName

Gibt den Namen des Verfügbarkeitssatzes an.

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

-DisableBootDiagnostics

Gibt an, dass die Konfiguration die Startdiagnose deaktiviert. Die Startdiagnose ist standardmäßig auf dem virtuellen Computer aktiviert.

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

-DiskLabel

Gibt eine Bezeichnung für den Betriebssystemdatenträger an.

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

-DiskName

Gibt einen Namen für den Betriebssystemdatenträger an.

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

-HostCaching

Gibt den Hostzwischenspeicherungsmodus für den Betriebssystemdatenträger an.

Gültige Werte sind:

  • ReadOnly
  • ReadWrite
Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImageName

Gibt den Namen des virtuellen Computerimages an, das für den Betriebssystemdatenträger verwendet werden soll.

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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • 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

-InstanceSize

Gibt die Größe der Instanz an.

Zulässige Werte für diesen Parameter:

  • Sehr klein
  • Klein
  • Medium
  • Groß
  • Extragroß
  • A5
  • A6
  • A7
  • A8
  • A9
  • Basic_A0
  • Basic_A1
  • Basic_A2
  • Basic_A3
  • Basic_A4
  • Standard_D1
  • Standard_D2
  • Standard_D3
  • Standard_D4
  • Standard_D11
  • Standard_D12
  • Standard_D13
  • Standard_D14
Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Label

Gibt eine Bezeichnung an, die dem virtuellen Computer zugewiesen werden soll.

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

-LicenseType

Gibt den Lizenztyp für ein Image oder einen Datenträger an, der lokal lizenziert ist. Zulässige Werte für diesen Parameter:

  • Windows_Client
  • Windows_Server

Geben Sie diesen Parameter nur für Bilder an, die das Windows Server-Betriebssystem enthalten.

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

-MediaLocation

Gibt den Azure-Speicherort für den neuen virtuellen Computerdatenträger an.

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

-Name

Gibt den Namen des virtuellen Computers an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
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