Udostępnij za pośrednictwem


New-AzStackHCIVMVirtualMachine

Operacja tworzenia lub aktualizowania maszyny wirtualnej. Pamiętaj, że niektóre właściwości można ustawić tylko podczas tworzenia maszyny wirtualnej.

Składnia

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   -ImageId <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -ImageName <String>
   [-ImageResourceGroup <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -OSDiskId <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -OSDiskName <String>
   [-OSDiskResourceGroup <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Operacja tworzenia lub aktualizowania maszyny wirtualnej. Pamiętaj, że niektóre właściwości można ustawić tylko podczas tworzenia maszyny wirtualnej.

Przykłady

Przykład 1. Tworzenie maszyny wirtualnej przy użyciu obrazu.

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux"  -ImageName "testImage" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm"  -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus"

Name            ResourceGroupName
----            -----------------
testVm          test-rg

To polecenie tworzy maszynę wirtualną na podstawie obrazu galerii.

Przykład 2. Tworzenie maszyny wirtualnej z dyskiem.

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux" -OsDiskName "testOsDisk10" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -Location "eastus"

Name            ResourceGroupName
----            -----------------
testVm          test-rg

To polecenie tworzy maszynę wirtualną z dysku.

Parametry

-AdminPassword

AdminPassword — hasło administratora

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AdminUsername

AdminUsername — nazwa użytkownika administratora

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia jako zadania

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ComputerName

ComputerName — nazwa komputera

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CustomLocationId

Nazwa lokalizacji rozszerzonej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DataDiskId

Dyski danych — lista dysków danych, które mają być dołączone do maszyny wirtualnej w formacie id.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DataDiskName

Dyski danych — lista dysków danych, które mają być dołączone do maszyny wirtualnej w formacie nazwy .

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DataDiskResourceGroup

Dyski danych — grupa zasobów dysków danych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisablePasswordAuthentication

DisablePasswordAuthentication — czy uwierzytelnianie haseł powinno być wyłączone

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DynamicMemoryMaximumMemoryInMb

Maksymalna pamięć dynamiczna

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DynamicMemoryMinimumMemoryInMb

Minimalna pamięć dynamiczna

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DynamicMemoryTargetBuffer

Definiuje ilość dodatkowej pamięci, która powinna być zarezerwowana dla maszyny wirtualnej w czasie wykonywania, jako procent całkowitej pamięci, którą uważa się za potrzebną maszynę wirtualną. Dotyczy to tylko systemów wirtualnych z włączoną pamięcią dynamiczną. Ta właściwość może mieścić się w zakresie od 5 do 2000.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableAutomaticUpdate

Określa, czy włączyćAutomaticUpdates na maszynie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableTpm

Służy do wskazywania, czy włączyć moduł TPM

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdentityType

Typ tożsamości.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ImageId

Identyfikator zasobu obrazu do utworzenia maszyny wirtualnej za pomocą polecenia .

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ImageName

Nazwa obrazu do utworzenia maszyny wirtualnej za pomocą polecenia .

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ImageResourceGroup

Grupa zasobów obrazu do utworzenia maszyny wirtualnej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja geograficzna, w której znajduje się zasób

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa maszyny wirtualnej

Typ:String
Aliasy:VirtualMachineName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NicId

NetworkInterfaces — lista interfejsów sieciowych, które mają być dołączone do maszyny wirtualnej w formacie identyfikatora usługi ARM.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NicName

NetworkInterfaces — lista interfejsów sieciowych, które mają być dołączone do maszyny wirtualnej w formacie nazwy.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NicResourceGroup

NetworkInterfaces — grupa zasobów interfejsów sieciowych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoWait

Uruchom polecenie asynchronicznie

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OSDiskId

Identyfikator zasobu dysku systemu operacyjnego

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OSDiskName

Nazwa dysku systemu operacyjnego

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OSDiskResourceGroup

Grupa zasobów dysku systemu operacyjnego

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OsType

OsType — ciąg określający, czy system operacyjny to Linux, czy Windows

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProvisionVMAgent

Służy do wskazywania, czy dołączanie agenta usługi Arc for Servers powinno być wyzwalane podczas procesu tworzenia maszyny wirtualnej. Agent maszyny wirtualnej jest domyślnie prowokowany. Przekaż polecenie -ProvisionVMAgent:$false, aby wyłączyć.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ProvisionVMConfigAgent

Wskazuje, czy agent konfiguracji maszyny wirtualnej powinien być aprowizowany na maszynie wirtualnej. Jeśli ta właściwość nie zostanie określona, domyślne zachowanie polega na ustawieniu jej na wartość true. Agent konfiguracji maszyny wirtualnej jest domyślnie aprowizowany. Aby wyłączyć polecenie -ProvisionVMConfigAgent:$false, przekaż polecenie -ProvisionVMConfigAgent:$false.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SecureBootEnabled

Określa, czy bezpieczny rozruch powinien być włączony na maszynie wirtualnej.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SshPublicKey

PublicKeys — lista kluczy publicznych SSH używanych do uwierzytelniania za pomocą maszyn wirtualnych

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StoragePathId

Identyfikator kontenera magazynu, który hostuje plik konfiguracji maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StoragePathName

Nazwa kontenera magazynu, który hostuje plik konfiguracji maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StoragePathResourceGroup

Grupa zasobów kontenera magazynu. Jeśli ta wartość nie zostanie podana, grupa zasobów maszyny wirtualnej zostanie użyta.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Identyfikator subskrypcji docelowej.

Typ:String
Position:Named
Domyślna wartość:(Get-AzContext).Subscription.Id
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeZone

Strefa czasowa dla maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VmMemoryInMB

Pamięć RAM w MB dla maszyny wirtualnej

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VmProcessor

Liczba procesorów dla maszyny wirtualnej

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VmSize

Rozmiar maszyny wirtualnej. Może być wstępnie zdefiniowanym rozmiarem lub niestandardowym. Możliwe wstępnie zdefiniowane rozmiary obejmują — niestandardowe, Standard_A2_v2,Standard_A4_v2,Standard_D16s_v3,Standard_D2s_v3,Standard_D32s_v3,Standard_D4s_v3,Standard_D8s_v3,Standard_DS13_v2,Standard_DS2_v2,Standard_DS3_v2,Standard_DS4_v2,Standard_DS5_v2,Standard_K8S2_v1,Standard_K8S3_v1,Standard_K8S4_v1,Standard_K8S5_v1,Standard_K8S_v1, Standard_NK12,Standard_NK6,Standard_NV12, StandardNv6

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

IVirtualMachineInstance