Udostępnij przez

New-AzureQuickVM

  • Odwołanie
Moduł:
Azure

Konfiguruje i tworzy maszynę wirtualną platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API zarządzania usługami. Zobacz moduł Az programu PowerShell, aby uzyskać polecenia cmdlet do zarządzania zasobami usługi Azure Resource Manager.

Składnia

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>]

Opis

Polecenie cmdlet New-AzureQuickVM konfiguruje i tworzy maszynę wirtualną platformy Azure. To polecenie cmdlet może wdrożyć maszynę wirtualną w istniejącej usłudze platformy Azure. To polecenie cmdlet może również utworzyć usługę platformy Azure, która hostuje nową maszynę wirtualną.

Przykłady

Przykład 1. Tworzenie maszyny wirtualnej

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

To polecenie tworzy maszynę wirtualną, na której działa system operacyjny Windows w istniejącej usłudze. Polecenie cmdlet opiera maszynę wirtualną na określonym obrazie. Polecenie określa parametr WaitForBoot . W związku z tym polecenie cmdlet czeka na uruchomienie maszyny wirtualnej.

Przykład 2. Tworzenie maszyny wirtualnej przy użyciu certyfikatów

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

Pierwsze polecenie pobiera certyfikaty z magazynu i przechowuje je w zmiennej $certs.

Drugie polecenie tworzy maszynę wirtualną, która uruchamia system operacyjny Windows w istniejącej usłudze na podstawie obrazu. Domyślnie odbiornik Https usługi WinRM jest włączony na maszynie wirtualnej. Polecenie określa parametr WaitForBoot . W związku z tym polecenie cmdlet czeka na uruchomienie maszyny wirtualnej. Polecenie przekazuje certyfikat WinRM i X509Certificates do hostowanej usługi.

Przykład 3. Tworzenie maszyny wirtualnej z systemem operacyjnym Linux

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

To polecenie tworzy maszynę wirtualną, która uruchamia system operacyjny Linux na podstawie obrazu. To polecenie tworzy usługę do hostowania nowej maszyny wirtualnej. Polecenie określa lokalizację usługi.

Przykład 4. Tworzenie maszyny wirtualnej i tworzenie usługi do hostowania nowej maszyny wirtualnej

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

Pierwsze polecenie pobiera lokalizacje przy użyciu polecenia cmdlet Get-AzureLocation , a następnie zapisuje je w zmiennej tablicy $Locations.

Drugie polecenie pobiera dostępne obrazy przy użyciu polecenia cmdlet Get-AzureVMImage , a następnie zapisuje je w zmiennej tablicy $Images.

Ostatnie polecenie tworzy dużą maszynę wirtualną o nazwie VirtualMachine25. Maszyna wirtualna uruchamia system operacyjny Windows. Jest on oparty na jednym z obrazów w $Images. Polecenie tworzy usługę o nazwie ContosoService03 dla nowej maszyny wirtualnej. Usługa znajduje się w lokalizacji w $Locations.

Przykład 5. Tworzenie maszyny wirtualnej, która ma zarezerwowaną nazwę IP

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

Pierwsze polecenie pobiera lokalizacje, a następnie przechowuje je w zmiennej tablicy $Locations.

Drugie polecenie pobiera dostępne obrazy, a następnie przechowuje je w zmiennej tablicy $Images.

Ostatnie polecenie tworzy maszynę wirtualną o nazwie VirtualMachine27 na podstawie jednego z obrazów w $Images. Polecenie tworzy usługę w lokalizacji w $Locations. Maszyna wirtualna ma zarezerwowaną nazwę IP, wcześniej przechowywaną w zmiennej $ipName.

Parametry

-AdminUsername

Określa nazwę użytkownika konta administratora, które to polecenie cmdlet tworzy na maszynie wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AffinityGroup

Określa grupę koligacji dla maszyny wirtualnej. Określ ten parametr lub parametr Location tylko wtedy, gdy to polecenie cmdlet tworzy usługę platformy Azure dla maszyny wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilitySetName

Określa nazwę zestawu dostępności, w którym to polecenie cmdlet tworzy maszynę wirtualną.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Certificates

Określa listę certyfikatów używanych przez to polecenie cmdlet do utworzenia usługi.

Type:CertificateSettingList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomDataFile

Określa plik danych dla maszyny wirtualnej. To polecenie cmdlet koduje zawartość pliku jako Base64. Plik musi być mniejszy niż 64 kilobajty długości.

Jeśli system operacyjny gościa jest systemem operacyjnym Windows, to polecenie cmdlet zapisuje te dane jako plik binarny o nazwie %SYSTEMDRIVE%\AzureData\CustomData.bin.

Jeśli system operacyjny gościa to Linux, to polecenie cmdlet przekazuje dane przy użyciu pliku ovf-env.xml. Instalacja kopiuje ten plik do katalogu /var/lib/waagent. Agent przechowuje również dane zakodowane w formacie Base64 w /var/lib/waagent/CustomData.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableGuestAgent

Wskazuje, że to polecenie cmdlet wyłącza agenta gościa aprowizacji infrastruktury jako usługi (IaaS).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWinRMHttps

Wskazuje, że to polecenie cmdlet wyłącza zdalne zarządzanie systemem Windows (WinRM) przy użyciu protokołu HTTPS. Domyślnie usługa WinRM jest włączona za pośrednictwem protokołu HTTPS.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsSettings

Określa tablicę obiektów serwera DNS, która definiuje ustawienia DNS dla nowego wdrożenia. Aby utworzyć obiekt DnsServer , użyj polecenia cmdlet New-AzureDns .

Type:DnsServer[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableWinRMHttp

Wskazuje, że to polecenie cmdlet włącza usługę WinRM za pośrednictwem protokołu HTTP.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostCaching

Określa tryb buforowania hosta dla dysku systemu operacyjnego. Prawidłowe wartości:

  • Tylko do odczytu
  • Readwrite
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageName

Określa nazwę obrazu dysku używanego przez to polecenie cmdlet do utworzenia dysku systemu operacyjnego.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • Silentlycontinue
  • Stop
  • Wstrzymanie
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceSize

Określa rozmiar wystąpienia. Prawidłowe wartości:

  • ExtraSmall
  • Mały
  • Średnia
  • Duży
  • EkstraLarge
  • A5
  • A6
  • A7
  • A8
  • A9
  • Basic_A0
  • Basic_A1
  • Basic_A2
  • Basic_A3
  • Basic_A4
  • Standardowa_D1
  • Standardowa_D2
  • Standardowa_D3
  • Standardowa_D4
  • Standardowa_D11
  • Standardowa_D12
  • Standardowa_D13
  • Standardowa_D14
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

Wskazuje, że to polecenie cmdlet tworzy maszynę wirtualną opartą na systemie Linux.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LinuxUser

Określa nazwę użytkownika konta administracyjnego systemu Linux, które to polecenie cmdlet tworzy na maszynie wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Określa centrum danych platformy Azure, które hostuje maszynę wirtualną. Jeśli określisz ten parametr, polecenie cmdlet utworzy usługę platformy Azure w określonej lokalizacji. Określ ten parametr lub parametr AffinityGroup tylko wtedy, gdy to polecenie cmdlet tworzy usługę platformy Azure dla maszyny wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MediaLocation

Określa lokalizację usługi Azure Storage, w której to polecenie cmdlet tworzy dyski maszyn wirtualnych.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę maszyny wirtualnej tworzonej przez to polecenie cmdlet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoExportPrivateKey

Wskazuje, że ta konfiguracja nie przekazuje klucza prywatnego.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWinRMEndpoint

Wskazuje, że to polecenie cmdlet nie dodaje punktu końcowego usługi WinRM dla maszyny wirtualnej.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Określa hasło dla konta administracyjnego.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReservedIPName

Określa zarezerwowaną nazwę adresu IP.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReverseDnsFqdn

Określa w pełni kwalifikowaną nazwę domeny dla odwrotnego wyszukiwania DNS.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Określa nazwę nowej lub istniejącej usługi platformy Azure, do której to polecenie cmdlet dodaje nową maszynę wirtualną.

Jeśli określisz nową usługę, te polecenia cmdlet go tworzą. Aby utworzyć nową usługę, należy określić parametr Location lub AffinityGroup .

Jeśli określisz istniejącą usługę, nie określ lokalizacji ani grupy koligacji.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SSHKeyPairs

Określa pary kluczy SSH.

Type:SSHKeyPairList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSHPublicKeys

Określa klucze publiczne SSH.

Type:SSHPublicKeyList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetNames

Określa tablicę nazw podsieci dla maszyny wirtualnej.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VNetName

Określa nazwę sieci wirtualnej dla maszyny wirtualnej.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForBoot

Wskazuje, że to polecenie cmdlet oczekuje, aż maszyna wirtualna osiągnie stan ReadyRole. Jeśli maszyna wirtualna osiągnie jeden z następujących stanów, polecenie cmdlet zakończy się niepowodzeniem: FailedStartingVM, ProvisioningFailed lub ProvisioningTimeout.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Windows

Wskazuje, że to polecenie cmdlet tworzy maszynę wirtualną z systemem Windows.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WinRMCertificate

Określa certyfikat, który to polecenie cmdlet kojarzy z punktem końcowym usługi WinRM.

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-X509Certificates

Określa tablicę certyfikatów X509 wdrożonych w hostowanej usłudze.

Type:X509Certificate2[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False