New-AzureQuickVM

Reference

Modul:: Azure

Nakonfiguruje a vytvoří virtuální počítač Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

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

Rutina New-AzureQuickVM nakonfiguruje a vytvoří virtuální počítač Azure. Tato rutina může nasadit virtuální počítač do existující služby Azure. Tato rutina může alternativně vytvořit službu Azure, která je hostitelem nového virtuálního počítače.

Příklady

Příklad 1: Vytvoření virtuálního počítače

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

Tento příkaz vytvoří virtuální počítač, na kterém běží operační systém Windows ve stávající službě. Rutina zakází virtuální počítač na zadané imagi. Příkaz určuje parametr WaitForBoot . Proto rutina čeká na spuštění virtuálního počítače.

Příklad 2: Vytvoření virtuálního počítače pomocí certifikátů

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

První příkaz získá certifikáty z úložiště a uloží je do $certs proměnné.

Druhý příkaz vytvoří virtuální počítač, na kterém běží operační systém Windows v existující službě z image. Ve výchozím nastavení je na virtuálním počítači povolený naslouchací proces Https WinRM. Příkaz určuje parametr WaitForBoot . Proto rutina čeká na spuštění virtuálního počítače. Příkaz nahraje certifikát WinRM a certifikát X509Certificates do hostované služby.

Příklad 3: Vytvoření virtuálního počítače, na kterém běží operační systém Linux

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

Tento příkaz vytvoří virtuální počítač, na kterém běží operační systém Linux z image. Tento příkaz vytvoří službu pro hostování nového virtuálního počítače. Příkaz určuje umístění služby.

Příklad 4: Vytvoření virtuálního počítače a vytvoření služby pro hostování nového virtuálního počítače

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

První příkaz získá umístění pomocí rutiny Get-AzureLocation a pak je uloží do proměnné pole $Locations.

Druhý příkaz získá dostupné image pomocí rutiny Get-AzureVMImage a uloží je do proměnné pole $Images.

Poslední příkaz vytvoří velký virtuální počítač s názvem VirtualMachine25. Virtuální počítač používá operační systém Windows. Je založená na jedné z imagí v $Images. Příkaz vytvoří službu s názvem ContosoService03 pro nový virtuální počítač. Služba je v umístění v $Locations.

Příklad 5: Vytvoření virtuálního počítače s vyhrazeným názvem IP adresy

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

První příkaz získá umístění a uloží je do proměnné pole $Locations.

Druhý příkaz získá dostupné obrázky a uloží je do proměnné pole $Images.

Poslední příkaz vytvoří virtuální počítač s názvem VirtualMachine27 na základě jedné z imagí v $Images. Příkaz vytvoří službu v umístění v $Locations. Virtuální počítač má vyhrazený název IP adresy, dříve uložený v proměnné $ipName.

Parametry

-AdminUsername

Určuje uživatelské jméno účtu správce, který tato rutina vytvoří na virtuálním počítači.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AffinityGroup

Určuje skupinu vztahů pro virtuální počítač. Tento parametr nebo parametr Location zadejte pouze v případě, že tato rutina pro virtuální počítač vytvoří službu Azure.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-AvailabilitySetName

Určuje název skupiny dostupnosti, ve které tato rutina vytvoří virtuální počítač.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Certificates

Určuje seznam certifikátů, které tato rutina používá k vytvoření služby.

Typ:	CertificateSettingList
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CustomDataFile

Určuje datový soubor pro virtuální počítač. Tato rutina kóduje obsah souboru jako Base64. Soubor musí být kratší než 64 kilobajtů.

Pokud je hostovaný operační systém operační systém Windows, tato rutina uloží tato data jako binární soubor s názvem %SYSTEMDRIVE%\AzureData\CustomData.bin.

Pokud je hostovaný operační systém Linux, tato rutina předává data pomocí souboru ovf-env.xml. Instalace zkopíruje tento soubor do adresáře /var/lib/waagent. Agent také ukládá data zakódovaná v base64 do /var/lib/waagent/CustomData.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableGuestAgent

Označuje, že tato rutina zakáže zřizování agenta hosta infrastruktury jako služby (IaaS).

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableWinRMHttps

Označuje, že tato rutina zakáže vzdálenou správu systému Windows (WinRM) na protokolu HTTPS. Ve výchozím nastavení je WinRM povolený přes PROTOKOL HTTPS.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DnsSettings

Určuje pole objektů serveru DNS, které definují nastavení DNS pro nové nasazení. K vytvoření objektu DnsServer použijte rutinu New-AzureDns .

Typ:	DnsServer[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EnableWinRMHttp

Označuje, že tato rutina povoluje WinRM přes HTTP.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-HostCaching

Určuje režim ukládání do mezipaměti hostitele pro disk operačního systému. Platné hodnoty jsou:

Jen pro čtení
ReadWrite

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ImageName

Určuje název image disku, pomocí které tato rutina vytvoří disk operačního systému.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

Pokračovat
Ignorovat
Informovat se
SilentlyContinue
Zastavit
Suspend

Typ:	ActionPreference
Aliasy:	infa
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InformationVariable

Určuje informační proměnnou.

Typ:	String
Aliasy:	iv
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InstanceSize

Určuje velikost instance. Platné hodnoty jsou:

ExtraSmall
Malá
Střední
Velká
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
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Linux

Označuje, že tato rutina vytvoří virtuální počítač založený na Linuxu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LinuxUser

Určuje uživatelské jméno účtu pro správu Linuxu, který tato rutina vytvoří na virtuálním počítači.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Location

Určuje datacentrum Azure, které je hostitelem virtuálního počítače. Pokud zadáte tento parametr, rutina vytvoří službu Azure v zadaném umístění. Tento parametr nebo parametr AffinityGroup zadejte pouze v případě, že tato rutina pro virtuální počítač vytvoří službu Azure.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-MediaLocation

Určuje umístění azure Storage, kde tato rutina vytvoří disky virtuálních počítačů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Určuje název virtuálního počítače, který tato rutina vytvoří.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoExportPrivateKey

Označuje, že tato konfigurace nenahrá privátní klíč.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoWinRMEndpoint

Označuje, že tato rutina nepřidá koncový bod WinRM pro virtuální počítač.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Password

Určuje heslo pro účet správce.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:	AzureSMProfile
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ReservedIPName

Určuje název rezervované IP adresy.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ReverseDnsFqdn

Určuje plně kvalifikovaný název domény pro reverzní vyhledávání DNS.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ServiceName

Určuje název nové nebo existující služby Azure, do které tato rutina přidá nový virtuální počítač.

Pokud zadáte novou službu, tato rutina ji vytvoří. Chcete-li vytvořit novou službu, je nutné zadat parametr Location nebo AffinityGroup .

Pokud zadáte existující službu, nezadávejte umístění ani skupinu spřažení.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SSHKeyPairs

Určuje páry klíčů SSH.

Typ:	SSHKeyPairList
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SSHPublicKeys

Určuje veřejné klíče SSH.

Typ:	SSHPublicKeyList
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubnetNames

Určuje pole názvů podsítě pro virtuální počítač.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VNetName

Určuje název virtuální sítě pro virtuální počítač.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WaitForBoot

Označuje, že tato rutina čeká, až se virtuální počítač dostane do stavu ReadyRole. Pokud virtuální počítač dosáhne jednoho z následujících stavů, rutina selže: FailedStartingVM, ProvisioningFailed nebo ProvisioningTimeout.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Windows

Označuje, že tato rutina vytvoří virtuální počítač s Windows.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WinRMCertificate

Určuje certifikát, který tato rutina přidruží ke koncovému bodu WinRM.

Typ:	X509Certificate2
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-X509Certificates

Určuje pole certifikátů X509 nasazených do hostované služby.

Typ:	X509Certificate2[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Sdílet prostřednictvím