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 |