New-AzureQuickVM

Referentie

Module:: Azure

Hiermee configureert en maakt u een virtuele Azure-machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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>]

Description

De cmdlet New-AzureQuickVM configureert en maakt een virtuele Azure-machine. Met deze cmdlet kunt u een virtuele machine implementeren in een bestaande Azure-service. Met deze cmdlet kunt u ook een Azure-service maken die als host fungeert voor de nieuwe virtuele machine.

Voorbeelden

Voorbeeld 1: Een virtuele machine maken

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

Met deze opdracht maakt u een virtuele machine waarop het Windows-besturingssysteem in een bestaande service wordt uitgevoerd. De cmdlet baseert de virtuele machine op de opgegeven installatiekopieën. Met de opdracht geeft u de parameter WaitForBoot op. Daarom wacht de cmdlet totdat de virtuele machine is gestart.

Voorbeeld 2: Een virtuele machine maken met behulp van certificaten

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

Met de eerste opdracht worden certificaten uit een archief opgehaald en opgeslagen in de $certs variabele.

Met de tweede opdracht maakt u een virtuele machine waarop het Windows-besturingssysteem wordt uitgevoerd in een bestaande service vanuit een installatiekopieën. WinRM Https-listener is standaard ingeschakeld op de virtuele machine. Met de opdracht geeft u de parameter WaitForBoot op. Daarom wacht de cmdlet totdat de virtuele machine is gestart. Met de opdracht worden een WinRM-certificaat en X509Certificates geüpload naar de gehoste service.

Voorbeeld 3: Een virtuele machine maken waarop het Linux-besturingssysteem wordt uitgevoerd

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

Met deze opdracht maakt u een virtuele machine waarop het Linux-besturingssysteem wordt uitgevoerd op basis van een installatiekopieën. Met deze opdracht maakt u een service voor het hosten van de nieuwe virtuele machine. Met de opdracht geeft u een locatie voor de service op.

Voorbeeld 4: Een virtuele machine maken en een service maken om de nieuwe virtuele machine te hosten

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

De eerste opdracht haalt locaties op met behulp van de Cmdlet Get-AzureLocation en slaat deze vervolgens op in de $Locations matrixvariabele.

Met de tweede opdracht worden beschikbare installatiekopieën opgehaald met behulp van de cmdlet Get-AzureVMImage en worden deze vervolgens opgeslagen in de $Images matrixvariabele.

Met de laatste opdracht maakt u een grote virtuele machine met de naam VirtualMachine25. Op de virtuele machine wordt het Windows-besturingssysteem uitgevoerd. Het is gebaseerd op een van de afbeeldingen in $Images. Met de opdracht maakt u een service met de naam ContosoService03 voor de nieuwe virtuele machine. De service bevindt zich op een locatie in $Locations.

Voorbeeld 5: Een virtuele machine maken met een gereserveerde IP-naam

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

Met de eerste opdracht worden locaties opgeslagen en vervolgens opgeslagen in de $Locations matrixvariabele.

Met de tweede opdracht worden beschikbare afbeeldingen opgehaald en vervolgens opgeslagen in de $Images matrixvariabele.

Met de laatste opdracht maakt u een virtuele machine met de naam VirtualMachine27 op basis van een van de installatiekopieën in $Images. Met de opdracht maakt u een service op een locatie in $Locations. De virtuele machine heeft een gereserveerde IP-naam die eerder is opgeslagen in de $ipName-variabele.

Parameters

-AdminUsername

Hiermee geeft u de gebruikersnaam op van het Administrator-account dat met deze cmdlet op de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AffinityGroup

Hiermee geeft u de affiniteitsgroep voor de virtuele machine op. Geef deze parameter of de locatieparameter alleen op als met deze cmdlet een Azure-service voor de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AvailabilitySetName

Hiermee geeft u de naam van de beschikbaarheidsset waarin deze cmdlet de virtuele machine maakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Certificates

Hiermee geeft u een lijst met certificaten op die door deze cmdlet worden gebruikt om de service te maken.

Type:	CertificateSettingList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CustomDataFile

Hiermee geeft u een gegevensbestand voor de virtuele machine. Met deze cmdlet wordt de inhoud van het bestand gecodeerd als Base64. Het bestand moet minder dan 64 kilobytes lang zijn.

Als het gastbesturingssysteem het Windows-besturingssysteem is, slaat deze cmdlet deze gegevens op als een binair bestand met de naam %SYSTEMDRIVE%\AzureData\CustomData.bin.

Als het gastbesturingssysteem Linux is, geeft deze cmdlet de gegevens door met behulp van het ovf-env.xml-bestand. Installatie kopieert dat bestand naar de map /var/lib/waagent. De agent slaat ook de met Base64 gecodeerde gegevens op in /var/lib/waagent/CustomData.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableGuestAgent

Hiermee wordt aangegeven dat met deze cmdlet de gastagent infrastructure as a service (IaaS) wordt uitgeschakeld.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableWinRMHttps

Geeft aan dat met deze cmdlet Windows Remote Management (WinRM) op HTTPS wordt uitgeschakeld. WinRM is standaard ingeschakeld via HTTPS.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DnsSettings

Hiermee geeft u een matrix van DNS-serverobjecten die de DNS-instellingen voor de nieuwe implementatie definiëren. Gebruik de cmdlet New-AzureDns om een DnsServer-object te maken.

Type:	DnsServer[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EnableWinRMHttp

Geeft aan dat deze cmdlet WinRM via HTTP inschakelt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-HostCaching

Hiermee geeft u de hostcachingmodus voor de besturingssysteemschijf. Geldige waarden zijn:

Alleen-lezen
ReadWrite

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ImageName

Hiermee geeft u de naam op van de schijfinstallatiekopieën die door deze cmdlet worden gebruikt om de besturingssysteemschijf te maken.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

Verdergaan
Negeren
Vragen
SilentlyContinue
Stoppen
Onderbreken

Type:	ActionPreference
Aliassen:	infa
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:	String
Aliassen:	iv
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InstanceSize

Hiermee geeft u de grootte van het exemplaar. Geldige waarden zijn:

ExtraSmall
Klein
Gemiddeld
Groot
ExtraLarge
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
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Linux

Geeft aan dat met deze cmdlet een virtuele Linux-machine wordt gemaakt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-LinuxUser

Hiermee geeft u de gebruikersnaam op van het Linux-beheerdersaccount dat met deze cmdlet op de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Location

Hiermee geeft u het Azure-datacenter op dat als host fungeert voor de virtuele machine. Als u deze parameter opgeeft, maakt de cmdlet een Azure-service op de opgegeven locatie. Geef deze parameter of de parameter AffinityGroup alleen op als met deze cmdlet een Azure-service voor de virtuele machine wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MediaLocation

Hiermee geeft u de Azure Storage-locatie op waar met deze cmdlet de schijven van de virtuele machines worden gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

Hiermee geeft u de naam op van de virtuele machine die met deze cmdlet wordt gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoExportPrivateKey

Geeft aan dat deze configuratie de persoonlijke sleutel niet uploadt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NoWinRMEndpoint

Geeft aan dat deze cmdlet geen WinRM-eindpunt toevoegt voor de virtuele machine.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Password

Hiermee geeft u het wachtwoord voor het beheerdersaccount.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ReservedIPName

Hiermee geeft u de gereserveerde IP-naam.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ReverseDnsFqdn

Hiermee geeft u de fully qualified domain name voor reverse DNS look up.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ServiceName

Hiermee geeft u de naam op van een nieuwe of bestaande Azure-service waaraan deze cmdlet de nieuwe virtuele machine toevoegt.

Als u een nieuwe service opgeeft, worden deze door deze cmdlets gemaakt. Als u een nieuwe service wilt maken, moet u de parameter Location of AffinityGroup opgeven.

Als u een bestaande service opgeeft, geeft u geen Locatie of AffinityGroup op.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSHKeyPairs

Hiermee geeft u SSH-sleutelparen op.

Type:	SSHKeyPairList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SSHPublicKeys

Hiermee geeft u openbare SSH-sleutels op.

Type:	SSHPublicKeyList
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SubnetNames

Hiermee geeft u een matrix van namen van subnet voor de virtuele machine.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-VNetName

Hiermee geeft u de naam van een virtueel netwerk voor de virtuele machine.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WaitForBoot

Geeft aan dat deze cmdlet wacht totdat de virtuele machine de status ReadyRole heeft bereikt. Als de virtuele machine een van de volgende statussen bereikt, mislukt de cmdlet: FailedStartingVM, ProvisioningFailed of ProvisioningTimeout.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Windows

Geeft aan dat met deze cmdlet een virtuele Windows-machine wordt gemaakt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WinRMCertificate

Hiermee geeft u een certificaat op dat deze cmdlet aan een WinRM-eindpunt koppelt.

Type:	X509Certificate2
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-X509Certificates

Hiermee geeft u een matrix van X509-certificaten op die zijn geïmplementeerd in een gehoste service.

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Delen via