New-AzureQuickVM

Referenz

Modul:: Azure

Konfiguriert und erstellt einen virtuellen Azure-Computer.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailabilitySetName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Certificates

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

Type:	CertificateSettingList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Datei "ovf-env.xml". Die Installation kopiert diese Datei in das Verzeichnis "/var/lib/waagent". Der Agent speichert auch die base64-codierten Daten in /var/lib/waagent/CustomData.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableGuestAgent

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWinRMHttps

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	DnsServer[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableWinRMHttp

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostCaching

Gibt den Hostzwischenspeicherungsmodus für den Betriebssystemdatenträger an. Gültige Werte sind:

ReadOnly
ReadWrite

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageName

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

Fortfahren
Ignorieren
Fragen
SilentlyContinue
Beenden
Angehalten

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Gibt eine Informationsvariable an.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceSize

Gibt die Größe der Instanz an. Gültige Werte sind:

Sehr klein
Klein
Mittel
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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Linux

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxUser

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoExportPrivateKey

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWinRMEndpoint

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

Gibt das Kennwort für das Administratorkonto an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

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

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReservedIPName

Gibt den reservierten IP-Namen an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ReverseDnsFqdn

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHKeyPairs

Gibt SSH-Schlüsselpaare an.

Type:	SSHKeyPairList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHPublicKeys

Gibt öffentliche SSH-Schlüssel an.

Type:	SSHPublicKeyList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetNames

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VNetName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Windows

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinRMCertificate

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

Type:	X509Certificate2
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Certificates

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

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False