New-AzureQuickVM

Referencia

Modul:: Azure

Konfigurál és létrehoz egy Azure-beli virtuális gépet.

Feljegyzés

A jelen dokumentációban hivatkozott parancsmagok az Azure Service Manager (ASM) API-kat használó örökölt Azure-erőforrások kezelésére szolgálnak. Ez az örökölt PowerShell-modul nem ajánlott új erőforrások létrehozásakor, mivel az ASM a kivonásra van ütemezve. További információkért lásd az Azure Service Manager kivonását.

Az Az PowerShell-modul az ajánlott PowerShell-modul az Azure Resource Manager-erőforrások PowerShell-lel való kezeléséhez.

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

A New-AzureQuickVM parancsmag konfigurál és létrehoz egy Azure-beli virtuális gépet. Ez a parancsmag üzembe helyezhet egy virtuális gépet egy meglévő Azure-szolgáltatásban. Ez a parancsmag másik lehetőségként létrehozhat egy Azure-szolgáltatást, amely az új virtuális gépet üzemelteti.

Példák

1. példa: Virtuális gép létrehozása

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

Ez a parancs létrehoz egy virtuális gépet, amely egy meglévő szolgáltatásban futtatja a Windows operációs rendszert. A parancsmag a virtuális gépet a megadott rendszerképre alapozza. A parancs a WaitForBoot paramétert adja meg. Ezért a parancsmag megvárja, amíg a virtuális gép elindul.

2. példa: Virtuális gép létrehozása tanúsítványok használatával

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

Az első parancs lekéri a tanúsítványokat egy tárolóból, és a $certs változóban tárolja őket.

A második parancs létrehoz egy virtuális gépet, amely egy rendszerképből futtatja a Windows operációs rendszert egy meglévő szolgáltatásban. Alapértelmezés szerint a WinRM Https-figyelő engedélyezve van a virtuális gépen. A parancs a WaitForBoot paramétert adja meg. Ezért a parancsmag megvárja, amíg a virtuális gép elindul. A parancs feltölt egy WinRM-tanúsítványt, és X509Certificates-t a üzemeltetett szolgáltatásba.

3. példa: Linux operációs rendszert futtató virtuális gép létrehozása

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

Ez a parancs létrehoz egy virtuális gépet, amely egy rendszerképből futtatja a Linux operációs rendszert. Ez a parancs létrehoz egy szolgáltatást az új virtuális gép üzemeltetéséhez. A parancs megadja a szolgáltatás helyét.

4. példa: Virtuális gép létrehozása és szolgáltatás létrehozása az új virtuális gép üzemeltetéséhez

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

Az első parancs a Get-AzureLocation parancsmaggal szerzi be a helyeket, majd a $Locations tömbváltozóban tárolja őket.

A második parancs a Get-AzureVMImage parancsmaggal lekéri az elérhető képeket, majd a $Images tömbváltozóban tárolja őket.

Az utolsó parancs létrehoz egy VirtualMachine25 nevű nagy virtuális gépet. A virtuális gép futtatja a Windows operációs rendszert. A $Images egyik képén alapul. A parancs létrehoz egy ContosoService03 nevű szolgáltatást az új virtuális géphez. A szolgáltatás $Locations egy helyen található.

5. példa: Fenntartott IP-névvel rendelkező virtuális gép létrehozása

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

Az első parancs lekéri a helyeket, majd a $Locations tömbváltozóban tárolja őket.

A második parancs elérhetővé teszi a rendszerképeket, majd a $Images tömbváltozóban tárolja őket.

Az utolsó parancs létrehoz egy VirtualMachine27 nevű virtuális gépet a $Images egyik rendszerképe alapján. A parancs létrehoz egy szolgáltatást a $Locations egy helyén. A virtuális gépnek van egy fenntartott IP-címe, amelyet korábban a $ipName változóban tároltak.

Paraméterek

-AdminUsername

Megadja annak a rendszergazdai fióknak a felhasználónevét, amelyet a parancsmag a virtuális gépen hoz létre.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-AffinityGroup

Megadja a virtuális gép affinitási csoportját. Ezt a paramétert vagy a Hely paramétert csak akkor adja meg, ha ez a parancsmag létrehoz egy Azure-szolgáltatást a virtuális géphez.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-AvailabilitySetName

Megadja annak a rendelkezésre állási csoportnak a nevét, amelyben ez a parancsmag létrehozza a virtuális gépet.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Certificates

Megadja azoknak a tanúsítványoknak a listáját, amelyeket a parancsmag a szolgáltatás létrehozásához használ.

Típus:	CertificateSettingList
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CustomDataFile

Megadja a virtuális gép adatfájlját. Ez a parancsmag a fájl tartalmát Base64-ként kódolja. A fájlnak 64 kilobájtnál rövidebbnek kell lennie.

Ha a vendég operációs rendszer a Windows operációs rendszer, ez a parancsmag a következő nevű bináris fájlként menti az adatokat: %SYSTEMDRIVE%\AzureData\CustomData.bin.

Ha a vendég operációs rendszer Linux, ez a parancsmag a ovf-env.xml fájl használatával továbbítja az adatokat. A telepítés a fájlt a /var/lib/waagent könyvtárba másolja. Az ügynök a Base64 kódolású adatait is a /var/lib/waagent/CustomData fájlban tárolja.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisableGuestAgent

Azt jelzi, hogy ez a parancsmag letiltja az infrastruktúrát szolgáltatásként (IaaS) kiépítési vendégügynökként.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisableWinRMHttps

Azt jelzi, hogy ez a parancsmag letiltja a Windows Remote Managementet (WinRM) a HTTPS-en. Alapértelmezés szerint a WinRM engedélyezve van HTTPS-en keresztül.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DnsSettings

A DNS-kiszolgáló objektumainak tömbje, amely meghatározza az új üzembe helyezés DNS-beállításait. DnsServer-objektum létrehozásához használja a New-AzureDns parancsmagot.

Típus:	DnsServer[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-EnableWinRMHttp

Azt jelzi, hogy ez a parancsmag http-en keresztül engedélyezi a WinRM-et.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-HostCaching

Megadja az operációsrendszer-lemez gazdagép-gyorsítótárazási módját. Az érvényes értékek a következők:

Olvasás
ReadWrite

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ImageName

Megadja annak a lemezképnek a nevét, amelyet a parancsmag az operációs rendszer lemezének létrehozásához használ.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-InformationAction

Meghatározza, hogy ez a parancsmag hogyan reagál egy információs eseményre.

A paraméter elfogadható értékei a következők:

Folytatás
Mellőzés
Érdeklődik
SilentlyContinue
Leállítás
Felfüggesztés

Típus:	ActionPreference
Aliasok:	infa
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-InformationVariable

Egy információs változót ad meg.

Típus:	String
Aliasok:	iv
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-InstanceSize

A példány méretét adja meg. Az érvényes értékek a következők:

ExtraSmall
Small
Közepes
Nagy
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

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Linux

Azt jelzi, hogy ez a parancsmag létrehoz egy Linux-alapú virtuális gépet.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-LinuxUser

Megadja annak a Linux felügyeleti fióknak a felhasználónevét, amelyet a parancsmag a virtuális gépen hoz létre.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Location

A virtuális gépet üzemeltető Azure-adatközpontot adja meg. Ha megadja ezt a paramétert, a parancsmag létrehoz egy Azure-szolgáltatást a megadott helyen. Ezt a paramétert vagy az AffinityGroup paramétert csak akkor adja meg, ha ez a parancsmag létrehoz egy Azure-szolgáltatást a virtuális géphez.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-MediaLocation

Megadja azt az Azure Storage-helyet, ahol ez a parancsmag létrehozza a virtuális gépek lemezeit.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Name

Megadja a parancsmag által létrehozott virtuális gép nevét.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-NoExportPrivateKey

Azt jelzi, hogy ez a konfiguráció nem tölti fel a titkos kulcsot.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-NoWinRMEndpoint

Azt jelzi, hogy ez a parancsmag nem ad hozzá WinRM-végpontot a virtuális géphez.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Password

Megadja a rendszergazdai fiók jelszavát.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Profile

Azt az Azure-profilt adja meg, amelyből a parancsmag beolvassa. Ha nem ad meg profilt, ez a parancsmag a helyi alapértelmezett profilból olvas be.

Típus:	AzureSMProfile
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ReservedIPName

A fenntartott IP-nevet adja meg.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ReverseDnsFqdn

Megadja a teljes tartománynevet a fordított DNS-kereséshez.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ServiceName

Megadja egy új vagy meglévő Azure-szolgáltatás nevét, amelyhez ez a parancsmag hozzáadja az új virtuális gépet.

Ha új szolgáltatást ad meg, ez a parancsmag hozza létre. Új szolgáltatás létrehozásához meg kell adnia a Location vagy affinityGroup paramétert.

Ha meglévő szolgáltatást ad meg, ne adjon meg helyet vagy affinitáscsoportot.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SSHKeyPairs

SSH-kulcspárokat határoz meg.

Típus:	SSHKeyPairList
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SSHPublicKeys

Nyilvános SSH-kulcsokat ad meg.

Típus:	SSHPublicKeyList
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SubnetNames

A virtuális gép alhálózatának nevét tartalmazó tömböt ad meg.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-VNetName

Megadja a virtuális gép virtuális hálózatának nevét.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WaitForBoot

Azt jelzi, hogy ez a parancsmag megvárja, amíg a virtuális gép eléri a ReadyRole állapotot. Ha a virtuális gép a következő állapotok egyikét éri el, a parancsmag meghiúsul: FailedStartingVM, ProvisioningFailed vagy ProvisioningTimeout.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Windows

Azt jelzi, hogy ez a parancsmag létrehoz egy Windows rendszerű virtuális gépet.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WinRMCertificate

Egy tanúsítványt ad meg, amelyet ez a parancsmag egy WinRM-végponthoz társít.

Típus:	X509Certificate2
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-X509Certificates

Egy üzemeltetett szolgáltatásban üzembe helyezett X509-tanúsítványok tömbje.

Típus:	X509Certificate2[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Megosztás a következőn keresztül: