Dela via


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