Freigeben über


New-AzureQuickVM

Konfiguriert und erstellt einen virtuellen Azure-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-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureQuickVM konfiguriert und erstellt einen virtuellen Azure-Computer. Dieses Cmdlet kann einen virtuellen Computer in einem vorhandenen Azure-Dienst bereitstellen. Dieses Cmdlet kann alternativ einen Azure-Dienst erstellen, der den neuen virtuellen Computer hostt.

Beispiele

Beispiel 1: Erstellen eines virtuellen Computers

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

Mit diesem Befehl wird ein virtueller Computer erstellt, auf dem das Windows-Betriebssystem in einem vorhandenen Dienst ausgeführt wird. Das Cmdlet basiert auf dem virtuellen Computer auf dem angegebenen Image. Der Befehl gibt den WaitForBoot-Parameter an. Daher wartet das Cmdlet auf den Start des virtuellen Computers.

Beispiel 2: Erstellen eines virtuellen Computers mithilfe von Zertifikaten

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

Der erste Befehl ruft Zertifikate aus einem Speicher ab und speichert sie in der variablen $certs.

Der zweite Befehl erstellt einen virtuellen Computer, der das Windows-Betriebssystem in einem vorhandenen Dienst aus einem Image ausführt. WinRM Https-Listener ist standardmäßig auf dem virtuellen Computer aktiviert. Der Befehl gibt den WaitForBoot-Parameter an. Daher wartet das Cmdlet auf den Start des virtuellen Computers. Der Befehl lädt ein WinRM-Zertifikat und X509Certificates in den gehosteten Dienst hoch.

Beispiel 3: Erstellen eines virtuellen Computers, auf dem das Linux-Betriebssystem ausgeführt wird

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

Mit diesem Befehl wird ein virtueller Computer erstellt, auf dem das Linux-Betriebssystem aus einem Image ausgeführt wird. Mit diesem Befehl wird ein Dienst zum Hosten des neuen virtuellen Computers erstellt. Der Befehl gibt einen Speicherort für den Dienst an.

Beispiel 4: Erstellen eines virtuellen Computers und Erstellen eines Diensts zum Hosten des neuen virtuellen Computers

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

Der erste Befehl ruft Speicherorte mithilfe des Cmdlets "Get-AzureLocation " ab und speichert sie dann in der $Locations Arrayvariable.

Der zweite Befehl ruft mithilfe des Cmdlets "Get-AzureVMImage " verfügbare Bilder ab und speichert sie dann in der $Images Arrayvariable.

Der letzte Befehl erstellt einen großen virtuellen Computer namens VirtualMachine25. Der virtuelle Computer führt das Windows-Betriebssystem aus. Sie basiert auf einem der Bilder in $Images. Der Befehl erstellt einen Dienst namens ContosoService03 für den neuen virtuellen Computer. Der Dienst befindet sich an einem Ort in $Locations.

Beispiel 5: Erstellen eines virtuellen Computers mit reserviertem IP-Namen

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

Der erste Befehl ruft Speicherorte ab und speichert sie dann in der $Locations Arrayvariable.

Der zweite Befehl ruft verfügbare Bilder ab und speichert sie dann in der $Images Arrayvariable.

Der letzte Befehl erstellt einen virtuellen Computer namens VirtualMachine27 basierend auf einem der Images in $Images. Der Befehl erstellt einen Dienst an einem Ort in $Locations. Der virtuelle Computer verfügt über einen reservierten IP-Namen, der zuvor in der variablen $ipName gespeichert wurde.

Parameter

-AdminUsername

Gibt den Benutzernamen des Administratorkontos an, das dieses Cmdlet auf dem virtuellen Computer erstellt.

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

-AffinityGroup

Gibt die Affinitätsgruppe für den virtuellen Computer an. Geben Sie diesen Parameter oder den Location-Parameter nur an, wenn dieses Cmdlet einen Azure-Dienst für den virtuellen Computer erstellt.

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

-AvailabilitySetName

Gibt den Namen des Verfügbarkeitssatzes an, in dem dieses Cmdlet den virtuellen Computer erstellt.

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

-Certificates

Gibt eine Liste von Zertifikaten an, die dieses Cmdlet zum Erstellen des Diensts verwendet.

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

-CustomDataFile

Gibt eine Datendatei für den virtuellen Computer an. Dieses Cmdlet codiert den Inhalt der Datei als Base64. Die Datei muss kleiner als 64 KB sein.

Wenn das Gastbetriebssystem das Windows-Betriebssystem ist, speichert dieses Cmdlet diese Daten als Binärdatei mit dem Namen %SYSTEMDRIVE%\AzureData\CustomData.bin.

Wenn das Gastbetriebssystem Linux ist, übergibt dieses Cmdlet die Daten mithilfe der ovf-env.xml-Datei. Die Installation kopiert diese Datei in das Verzeichnis "/var/lib/waagent". Der Agent speichert auch die base64-codierten Daten in /var/lib/waagent/CustomData.

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

-DisableGuestAgent

Gibt an, dass dieses Cmdlet die Infrastruktur als Dienst (IaaS) zur Bereitstellung von Gast-Agent deaktiviert.

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

-DisableWinRMHttps

Gibt an, dass dieses Cmdlet die Windows-Remoteverwaltung (WinRM) unter HTTPS deaktiviert. Standardmäßig ist WinRM über HTTPS aktiviert.

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

-DnsSettings

Gibt ein Array von DNS-Serverobjekten an, das die DNS-Einstellungen für die neue Bereitstellung definiert. Verwenden Sie zum Erstellen eines DnsServer-Objekts das Cmdlet New-AzureDns .

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

-EnableWinRMHttp

Gibt an, dass dieses Cmdlet WinRM über HTTP aktiviert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
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:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImageName

Gibt den Namen des Datenträgerimages an, das dieses Cmdlet zum Erstellen des Betriebssystemdatenträgers verwendet.

Typ:String
Position:Named
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. Gültige Werte sind:

  • 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:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Linux

Gibt an, dass dieses Cmdlet einen linuxbasierten virtuellen Computer erstellt.

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

-LinuxUser

Gibt den Benutzernamen des Linux-Verwaltungskontos an, das dieses Cmdlet auf dem virtuellen Computer erstellt.

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

-Location

Gibt das Azure-Rechenzentrum an, das den virtuellen Computer hosten soll. Wenn Sie diesen Parameter angeben, erstellt das Cmdlet einen Azure-Dienst am angegebenen Speicherort. Geben Sie diesen Parameter oder den AffinityGroup-Parameter nur an, wenn dieses Cmdlet einen Azure-Dienst für den virtuellen Computer erstellt.

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

-MediaLocation

Gibt den Azure Storage-Speicherort an, an dem dieses Cmdlet die Datenträger virtueller Computer erstellt.

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

-Name

Gibt den Namen des virtuellen Computers an, den dieses Cmdlet erstellt.

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

-NoExportPrivateKey

Gibt an, dass diese Konfiguration den privaten Schlüssel nicht hochlädt.

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

-NoWinRMEndpoint

Gibt an, dass dieses Cmdlet keinen WinRM-Endpunkt für den virtuellen Computer hinzugibt.

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

-Password

Gibt das Kennwort für das Administratorkonto an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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 reservierten IP-Namen an.

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

-ReverseDnsFqdn

Gibt den vollqualifizierten Domänennamen für die Reverse-DNS-Suche an.

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

-ServiceName

Gibt den Namen eines neuen oder vorhandenen Azure-Diensts an, dem dieses Cmdlet den neuen virtuellen Computer hinzufügt.

Wenn Sie einen neuen Dienst angeben, wird dieser von diesen Cmdlets erstellt. Um einen neuen Dienst zu erstellen, müssen Sie den Parameter "Location " oder "AffinityGroup " angeben.

Wenn Sie einen vorhandenen Dienst angeben, geben Sie nicht "Location" oder "AffinityGroup" an.

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

-SSHKeyPairs

Gibt SSH-Schlüsselpaare an.

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

-SSHPublicKeys

Gibt öffentliche SSH-Schlüssel an.

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

-SubnetNames

Gibt ein Array von Namen des Subnetzs für den virtuellen Computer an.

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

-VNetName

Gibt den Namen eines virtuellen Netzwerks für den virtuellen Computer an.

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 Status ReadyRole zu erreichen. Wenn der virtuelle Computer einen der folgenden Zustände erreicht, schlägt das Cmdlet fehl: FailedStartingVM, ProvisioningFailed oder ProvisioningTimeout.

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

-Windows

Gibt an, dass dieses Cmdlet einen virtuellen Windows-Computer erstellt.

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

-WinRMCertificate

Gibt ein Zertifikat an, das dieses Cmdlet einem WinRM-Endpunkt zuordnet.

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

-X509Certificates

Gibt ein Array von X509-Zertifikaten an, die für einen gehosteten Dienst bereitgestellt werden.

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