New-AzureQuickVM
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 programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
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" -WaitForBootTo 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] -WaitForBootPierwsze 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].namePierwsze 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 $ipNamePierwsze 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-AvailabilitySetName
Określa nazwę zestawu dostępności, w którym to polecenie cmdlet tworzy maszynę wirtualną.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Certificates
Określa listę certyfikatów używanych przez to polecenie cmdlet do utworzenia usługi.
| Typ: | CertificateSettingList |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DisableGuestAgent
Wskazuje, że to polecenie cmdlet wyłącza agenta gościa aprowizacji infrastruktury jako usługi (IaaS).
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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 .
| Typ: | DnsServer[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-EnableWinRMHttp
Wskazuje, że to polecenie cmdlet włącza usługę WinRM za pośrednictwem protokołu HTTP.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-HostCaching
Określa tryb buforowania hosta dla dysku systemu operacyjnego. Prawidłowe wartości to:
- Tylko do odczytu
- ReadWrite
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ImageName
Określa nazwę obrazu dysku używanego przez to polecenie cmdlet do utworzenia dysku systemu operacyjnego.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-InformationAction
Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.
Dopuszczalne wartości tego parametru to:
- Kontynuuj
- Ignoruj
- Zapytać
- SilentlyContinue
- Zatrzymaj
- Wstrzymanie
| Typ: | ActionPreference |
| Aliasy: | infa |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-InformationVariable
Określa zmienną informacyjną.
| Typ: | String |
| Aliasy: | iv |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-InstanceSize
Określa rozmiar wystąpienia. Prawidłowe wartości to:
- ExtraSmall
- Mały
- Śred.
- 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
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Linux
Wskazuje, że to polecenie cmdlet tworzy maszynę wirtualną opartą na systemie Linux.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-LinuxUser
Określa nazwę użytkownika konta administracyjnego systemu Linux, które to polecenie cmdlet tworzy na maszynie wirtualnej.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-MediaLocation
Określa lokalizację usługi Azure Storage, w której to polecenie cmdlet tworzy dyski maszyn wirtualnych.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę maszyny wirtualnej tworzonej przez to polecenie cmdlet.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-NoExportPrivateKey
Wskazuje, że ta konfiguracja nie przekazuje klucza prywatnego.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-NoWinRMEndpoint
Wskazuje, że to polecenie cmdlet nie dodaje punktu końcowego usługi WinRM dla maszyny wirtualnej.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Password
Określa hasło dla konta administracyjnego.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | AzureSMProfile |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ReservedIPName
Określa zarezerwowaną nazwę adresu IP.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ReverseDnsFqdn
Określa w pełni kwalifikowaną nazwę domeny dla odwrotnego wyszukiwania DNS.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SSHKeyPairs
Określa pary kluczy SSH.
| Typ: | SSHKeyPairList |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SSHPublicKeys
Określa klucze publiczne SSH.
| Typ: | SSHPublicKeyList |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-SubnetNames
Określa tablicę nazw podsieci dla maszyny wirtualnej.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-VNetName
Określa nazwę sieci wirtualnej dla maszyny wirtualnej.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Windows
Wskazuje, że to polecenie cmdlet tworzy maszynę wirtualną z systemem Windows.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WinRMCertificate
Określa certyfikat, który to polecenie cmdlet kojarzy z punktem końcowym usługi WinRM.
| Typ: | X509Certificate2 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-X509Certificates
Określa tablicę certyfikatów X509 wdrożonych w hostowanej usłudze.
| Typ: | X509Certificate2[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |