New-AzureQuickVM
Konfigurerar och skapar en virtuell Azure-dator.
Kommentar
De cmdletar som refereras i den här dokumentationen är till för att hantera äldre Azure-resurser som använder Service Management-API:er. Se Az PowerShell-modulen för cmdletar för att hantera Azure Resource Manager-resurser.
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>]
Description
Cmdleten New-AzureQuickVM konfigurerar och skapar en virtuell Azure-dator. Den här cmdleten kan distribuera en virtuell dator till en befintlig Azure-tjänst. Den här cmdleten kan också skapa en Azure-tjänst som är värd för den nya virtuella datorn.
Exempel
Exempel 1: Skapa en virtuell dator
PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot
Det här kommandot skapar en virtuell dator som kör Windows-operativsystemet i en befintlig tjänst. Cmdleten baserar den virtuella datorn på den angivna avbildningen. Kommandot anger parametern WaitForBoot . Därför väntar cmdleten på att den virtuella datorn ska starta.
Exempel 2: Skapa en virtuell dator med hjälp av certifikat
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
Det första kommandot hämtar certifikat från ett arkiv och lagrar dem i variabeln $certs.
Det andra kommandot skapar en virtuell dator som kör Windows-operativsystemet i en befintlig tjänst från en avbildning. Som standard är WinRM Https-lyssnaren aktiverad på den virtuella datorn. Kommandot anger parametern WaitForBoot . Därför väntar cmdleten på att den virtuella datorn ska starta. Kommandot överför ett WinRM-certifikat och X509Certificates till den värdbaserade tjänsten.
Exempel 3: Skapa en virtuell dator som kör Linux-operativsystemet
PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"
Det här kommandot skapar en virtuell dator som kör Linux-operativsystemet från en avbildning. Det här kommandot skapar en tjänst som värd för den nya virtuella datorn. Kommandot anger en plats för tjänsten.
Exempel 4: Skapa en virtuell dator och skapa en tjänst som värd för den nya virtuella datorn
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
Det första kommandot hämtar platser med cmdleten Get-AzureLocation och lagrar dem sedan i $Locations matrisvariabeln.
Det andra kommandot hämtar tillgängliga avbildningar med cmdleten Get-AzureVMImage och lagrar dem sedan i $Images matrisvariabeln.
Det sista kommandot skapar en stor virtuell dator med namnet VirtualMachine25. Den virtuella datorn kör Windows-operativsystemet. Den baseras på en av bilderna i $Images. Kommandot skapar en tjänst med namnet ContosoService03 för den nya virtuella datorn. Tjänsten finns på en plats i $Locations.
Exempel 5: Skapa en virtuell dator som har ett reserverat IP-namn
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
Det första kommandot hämtar platser och lagrar dem sedan i $Locations matrisvariabel.
Det andra kommandot hämtar tillgängliga avbildningar och lagrar dem sedan i $Images matrisvariabeln.
Det sista kommandot skapar en virtuell dator med namnet VirtualMachine27 baserat på en av bilderna i $Images. Kommandot skapar en tjänst på en plats i $Locations. Den virtuella datorn har ett reserverat IP-namn som tidigare lagrats i variabeln $ipName.
Parametrar
-AdminUsername
Anger användarnamnet för det administratörskonto som den här cmdleten skapar på den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AffinityGroup
Anger tillhörighetsgruppen för den virtuella datorn. Ange den här parametern eller platsparametern endast om den här cmdleten skapar en Azure-tjänst för den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailabilitySetName
Anger namnet på tillgänglighetsuppsättningen där den här cmdleten skapar den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Certificates
Anger en lista över certifikat som den här cmdleten använder för att skapa tjänsten.
Type: | CertificateSettingList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomDataFile
Anger en datafil för den virtuella datorn. Den här cmdleten kodar innehållet i filen som Base64. Filen måste vara mindre än 64 kilobyte lång.
Om gästoperativsystemet är Windows-operativsystemet sparar den här cmdleten dessa data som en binär fil med namnet %SYSTEMDRIVE%\AzureData\CustomData.bin.
Om gästoperativsystemet är Linux skickar den här cmdleten data med hjälp av filen ovf-env.xml. Installationen kopierar filen till katalogen /var/lib/waagent. Agenten lagrar även Base64-kodade data i /var/lib/waagent/CustomData.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableGuestAgent
Anger att den här cmdleten inaktiverar gästagenten infrastruktur som en tjänst (IaaS).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWinRMHttps
Anger att den här cmdleten inaktiverar Windows Remote Management (WinRM) på HTTPS. Som standard är WinRM aktiverat via HTTPS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DnsSettings
Anger en matris med DNS-serverobjekt som definierar DNS-inställningarna för den nya distributionen. Om du vill skapa ett DnsServer-objekt använder du cmdleten New-AzureDns .
Type: | DnsServer[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableWinRMHttp
Anger att den här cmdleten aktiverar WinRM via HTTP.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostCaching
Anger värdcachelagringsläget för operativsystemdisken. Giltiga värden är:
- Skrivskyddat
- Skriv upp
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageName
Anger namnet på den diskavbildning som den här cmdleten använder för att skapa operativsystemdisken.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
Anger hur den här cmdleten svarar på en informationshändelse.
De godtagbara värdena för den här parametern är:
- Fortsätt
- Ignorera
- Fråga
- TystKontinuera
- Stoppa
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Anger en informationsvariabel.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceSize
Anger instansens storlek. Giltiga värden är:
- ExtraSmall
- Litet
- Medium
- Stort
- 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Linux
Anger att den här cmdleten skapar en Linux-baserad virtuell dator.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinuxUser
Anger användarnamnet för det administrativa Linux-konto som den här cmdleten skapar på den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Anger det Azure-datacenter som är värd för den virtuella datorn. Om du anger den här parametern skapar cmdleten en Azure-tjänst på den angivna platsen. Ange den här parametern eller parametern AffinityGroup endast om den här cmdleten skapar en Azure-tjänst för den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MediaLocation
Anger den Azure Storage-plats där den här cmdleten skapar de virtuella datordiskarna.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Anger namnet på den virtuella dator som den här cmdleten skapar.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoExportPrivateKey
Anger att den här konfigurationen inte laddar upp den privata nyckeln.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWinRMEndpoint
Anger att den här cmdleten inte lägger till någon WinRM-slutpunkt för den virtuella datorn.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
Anger lösenordet för det administrativa kontot.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.
Type: | AzureSMProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReservedIPName
Anger det reserverade IP-namnet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReverseDnsFqdn
Anger det fullständigt kvalificerade domännamnet för omvänd DNS-sökning.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Anger namnet på en ny eller befintlig Azure-tjänst som den här cmdleten lägger till den nya virtuella datorn i.
Om du anger en ny tjänst skapar dessa cmdletar den. Om du vill skapa en ny tjänst måste du ange parametern Plats eller AffinityGroup .
Om du anger en befintlig tjänst ska du inte ange Plats eller AffinityGroup.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSHKeyPairs
Anger SSH-nyckelpar.
Type: | SSHKeyPairList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSHPublicKeys
Anger offentliga SSH-nycklar.
Type: | SSHPublicKeyList |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetNames
Anger en matris med namn på undernätet för den virtuella datorn.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VNetName
Anger namnet på ett virtuellt nätverk för den virtuella datorn.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WaitForBoot
Anger att den här cmdleten väntar på att den virtuella datorn ska nå tillståndet ReadyRole. Om den virtuella datorn når något av följande tillstånd misslyckas cmdleten: FailedStartingVM, ProvisioningFailed eller ProvisioningTimeout.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Windows
Anger att den här cmdleten skapar en virtuell Windows-dator.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WinRMCertificate
Anger ett certifikat som den här cmdleten associerar med en WinRM-slutpunkt.
Type: | X509Certificate2 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-X509Certificates
Anger en matris med X509-certifikat som distribueras till en värdbaserad tjänst.
Type: | X509Certificate2[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |