New-AzureQuickVM

Referens

Modul:: Azure

Konfigurerar och skapar en virtuell Azure-dator.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med 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>]

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.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AvailabilitySetName

Anger namnet på tillgänglighetsuppsättningen där den här cmdleten skapar den virtuella datorn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Certificates

Anger en lista över certifikat som den här cmdleten använder för att skapa tjänsten.

Typ:	CertificateSettingList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableGuestAgent

Anger att den här cmdleten inaktiverar gästagenten infrastruktur som en tjänst (IaaS).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisableWinRMHttps

Anger att den här cmdleten inaktiverar Windows Remote Management (WinRM) på HTTPS. Som standard är WinRM aktiverat via HTTPS.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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 .

Typ:	DnsServer[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EnableWinRMHttp

Anger att den här cmdleten aktiverar WinRM via HTTP.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-HostCaching

Anger värdcachelagringsläget för operativsystemdisken. Giltiga värden är:

Skrivskyddat
Skriv upp

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ImageName

Anger namnet på den diskavbildning som den här cmdleten använder för att skapa operativsystemdisken.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

Fortsätt
Ignorera
Fråga
TystKontinuera
Stoppa
Suspend

Typ:	ActionPreference
Alias:	infa
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InformationVariable

Anger en informationsvariabel.

Typ:	String
Alias:	iv
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Linux

Anger att den här cmdleten skapar en Linux-baserad virtuell dator.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LinuxUser

Anger användarnamnet för det administrativa Linux-konto som den här cmdleten skapar på den virtuella datorn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MediaLocation

Anger den Azure Storage-plats där den här cmdleten skapar de virtuella datordiskarna.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Anger namnet på den virtuella dator som den här cmdleten skapar.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoExportPrivateKey

Anger att den här konfigurationen inte laddar upp den privata nyckeln.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoWinRMEndpoint

Anger att den här cmdleten inte lägger till någon WinRM-slutpunkt för den virtuella datorn.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Password

Anger lösenordet för det administrativa kontot.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	AzureSMProfile
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ReservedIPName

Anger det reserverade IP-namnet.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ReverseDnsFqdn

Anger det fullständigt kvalificerade domännamnet för omvänd DNS-sökning.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SSHKeyPairs

Anger SSH-nyckelpar.

Typ:	SSHKeyPairList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SSHPublicKeys

Anger offentliga SSH-nycklar.

Typ:	SSHPublicKeyList
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SubnetNames

Anger en matris med namn på undernätet för den virtuella datorn.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-VNetName

Anger namnet på ett virtuellt nätverk för den virtuella datorn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Windows

Anger att den här cmdleten skapar en virtuell Windows-dator.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WinRMCertificate

Anger ett certifikat som den här cmdleten associerar med en WinRM-slutpunkt.

Typ:	X509Certificate2
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-X509Certificates

Anger en matris med X509-certifikat som distribueras till en värdbaserad tjänst.

Typ:	X509Certificate2[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Dela via