New-AzureRmVM

Referencia

Modul:: AzureRM.Compute

Létrehoz egy virtuális gépet.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

New-AzureRmVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   [[-Zone] <String[]>]
   -Name <String>
   -Credential <PSCredential>
   [-VirtualNetworkName <String>]
   [-AddressPrefix <String>]
   [-SubnetName <String>]
   [-SubnetAddressPrefix <String>]
   [-PublicIpAddressName <String>]
   [-DomainNameLabel <String>]
   [-AllocationMethod <String>]
   [-SecurityGroupName <String>]
   [-OpenPorts <Int32[]>]
   [-Image <String>]
   [-Size <String>]
   [-AvailabilitySetName <String>]
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-AsJob]
   [-DataDiskSizeInGb <Int32[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmVM
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-VM] <PSVirtualMachine>
   [[-Zone] <String[]>]
   [-DisableBginfoExtension]
   [-Tag <Hashtable>]
   [-LicenseType <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmVM
   [[-ResourceGroupName] <String>]
   [[-Location] <String>]
   -Name <String>
   [-VirtualNetworkName <String>]
   [-AddressPrefix <String>]
   [-SubnetName <String>]
   [-SubnetAddressPrefix <String>]
   [-PublicIpAddressName <String>]
   [-DomainNameLabel <String>]
   [-AllocationMethod <String>]
   [-SecurityGroupName <String>]
   [-OpenPorts <Int32[]>]
   -DiskFile <String>
   [-Linux]
   [-Size <String>]
   [-AvailabilitySetName <String>]
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-AsJob]
   [-DataDiskSizeInGb <Int32[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A New-AzureRmVM parancsmag létrehoz egy virtuális gépet az Azure-ban. Ez a parancsmag bemenetként egy virtuálisgép-objektumot vesz fel. Virtuálisgép-objektum létrehozásához használja a New-AzureRmVMConfig parancsmagot. Más parancsmagok is használhatók a virtuális gép konfigurálásához, például Set-AzureRmVMOperatingSystem, Set-AzureRmVMSourceImage, Add-AzureRmVMNetworkInterface és Set-AzureRmVMOSDisk. Ez SimpleParameterSet kényelmes módszert kínál a virtuális gépek létrehozásához a virtuális gépek közös létrehozásának argumentumainak megadása kötelezővé tételével.

Példák

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

PS C:\> New-AzureRmVM -Name MyVm -Credential (Get-Credential)

VERBOSE: Use 'mstsc /v:myvm-222222.eastus.cloudapp.azure.com' to connect to the VM.

ResourceGroupName        : MyVm
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyVm/provi
ders/Microsoft.Compute/virtualMachines/MyVm
VmId                     : 11111111-1111-1111-1111-111111111111
Name                     : MyVm
Type                     : Microsoft.Compute/virtualMachines
Location                 : eastus
Tags                     : {}
HardwareProfile          : {VmSize}
NetworkProfile           : {NetworkInterfaces}
OSProfile                : {ComputerName, AdminUsername, WindowsConfiguration, Secrets}
ProvisioningState        : Succeeded
StorageProfile           : {ImageReference, OsDisk, DataDisks}
FullyQualifiedDomainName : myvm-222222.eastus.cloudapp.azure.com

Ez a példaszkript bemutatja, hogyan hozhat létre virtuális gépet. A szkript felhasználónevet és jelszót kér a virtuális géphez. Ez a szkript számos más parancsmagot használ.

2. példa: Virtuális gép létrehozása egyéni felhasználói rendszerképből

PS C:\> ## VM Account
# Credentials for Local Admin account you created in the sysprepped (generalized) vhd image
$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
## Azure Account
$LocationName = "westus"
$ResourceGroupName = "MyResourceGroup"
# This a Premium_LRS storage account.
# It is required in order to run a client VM with efficiency and high performance.
$StorageAccount = "Mydisk"

## VM
$OSDiskName = "MyClient"
$ComputerName = "MyClientVM"
$OSDiskUri = "https://Mydisk.blob.core.windows.net/disks/MyOSDisk.vhd"
$SourceImageUri = "https://Mydisk.blob.core.windows.net/vhds/MyOSImage.vhd"
$VMName = "MyVM"
# Modern hardware environment with fast disk, high IOPs performance.
# Required to run a client VM with efficiency and performance
$VMSize = "Standard_DS3"
$OSDiskCaching = "ReadWrite"
$OSCreateOption = "FromImage"

## Networking
$DNSNameLabel = "mydnsname" # mydnsname.westus.cloudapp.azure.com
$NetworkName = "MyNet"
$NICName = "MyNIC"
$PublicIPAddressName = "MyPIP"
$SubnetName = "MySubnet"
$SubnetAddressPrefix = "10.0.0.0/24"
$VnetAddressPrefix = "10.0.0.0/16"

$SingleSubnet = New-AzureRmVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzureRmVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$PIP = New-AzureRmPublicIpAddress -Name $PublicIPAddressName -DomainNameLabel $DNSNameLabel -ResourceGroupName $ResourceGroupName -Location $LocationName -AllocationMethod Dynamic
$NIC = New-AzureRmNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id -PublicIpAddressId $PIP.Id

$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

$VirtualMachine = New-AzureRmVMConfig -VMName $VMName -VMSize $VMSize
$VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzureRmVMOSDisk -VM $VirtualMachine -Name $OSDiskName -VhdUri $OSDiskUri -SourceImageUri $SourceImageUri -Caching $OSDiskCaching -CreateOption $OSCreateOption -Windows

New-AzureRmVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose

Ez a példa egy meglévő, sys-előre összeállított, általánosított egyéni operációsrendszer-lemezképet használ, és egy adatlemezt csatol hozzá, kiépít egy új hálózatot, üzembe helyezi a VHD-t, és futtatja azt. Ez a szkript az automatikus kiépítéshez használható, mivel a helyi virtuális gép rendszergazdai hitelesítő adatait használja a beágyazottban a Get-Credential meghívása helyett, amely felhasználói beavatkozást igényel. Ez a szkript feltételezi, hogy már bejelentkezett az Azure-fiókjába. A bejelentkezési állapotot a Get-AzureSubscription parancsmaggal ellenőrizheti.

3. példa: Virtuális gép létrehozása piactéri rendszerképből nyilvános IP-cím nélkül

$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString <password> -AsPlainText -Force
$LocationName = "eastus2"
$ResourceGroupName = "MyResourceGroup"
$ComputerName = "MyVM"
$VMName = "MyVM"
$VMSize = "Standard_DS3"

$NetworkName = "MyNet"
$NICName = "MyNIC"
$SubnetName = "MySubnet"
$SubnetAddressPrefix = "10.0.0.0/24"
$VnetAddressPrefix = "10.0.0.0/16"

$SingleSubnet = New-AzureRmVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzureRmVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$NIC = New-AzureRmNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id

$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

$VirtualMachine = New-AzureRmVMConfig -VMName $VMName -VMSize $VMSize
$VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzureRmVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'WindowsServer' -Skus '2012-R2-Datacenter' -Version latest

New-AzureRmVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose

Ez a példa kiépít egy új hálózatot, és nyilvános IP-cím vagy hálózati biztonsági csoport létrehozása nélkül üzembe helyez egy Windows rendszerű virtuális gépet a Marketplace-en. Ez a szkript az automatikus kiépítéshez használható, mivel a helyi virtuális gép rendszergazdai hitelesítő adatait használja a beágyazottban a Get-Credential meghívása helyett, amely felhasználói beavatkozást igényel.

Paraméterek

-AddressPrefix

A virtuális géphez létrehozandó virtuális hálózat címelőtagja.

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

-AllocationMethod

A virtuális gép számára létrehozandó nyilvános IP-cím IP-foglalási módszere.

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

-AsJob

Futtassa a parancsmagot a háttérben, és adjon vissza egy feladatot a folyamat nyomon követéséhez.

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

-AvailabilitySetName

Megadja a rendelkezésre állási csoport 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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Credential

A virtuális gép rendszergazdai hitelesítő adatai.

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

-DataDiskSizeInGb

Megadja az adatlemezek méretét GB-ban.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-DisableBginfoExtension

Azt jelzi, hogy ez a parancsmag nem telepíti a BG Info bővítményt a virtuális gépre.

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

-DiskFile

A felhőbe feltöltendő virtuális merevlemez-fájl helyi elérési útja és a virtuális gép létrehozása, és utótagként a ".vhd" névnek kell lennie.

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

-DomainNameLabel

A virtuális gép teljes tartománynevének (FQDN) altartománycímkéje. Ez lesz az űrlap {domainNameLabel}.{location}.cloudapp.azure.com.

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

-Image

A rövid rendszerkép neve, amelyre a virtuális gép épül. Ezek a következők: Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, Win2008R2SP1, UbuntuLTS, CentOS, CoreOS, Debian, openSU Standard kiadás-Ugrás, RHEL, SLES.

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

-LicenseType

Megadja a licenc típusát, amely azt jelzi, hogy a virtuális gép lemezképe vagy lemeze helyszíni licenccel rendelkezik. Ez az érték csak a Windows Server operációs rendszert tartalmazó képekhez használható. A paraméter elfogadható értékei a következők:

Windows_Client
Windows_Server Ez az érték nem frissíthető. Ha ezt a paramétert egy frissítéshez adja meg, az értéknek meg kell egyeznie a virtuális gép kezdeti értékével.

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

-Linux

Azt jelzi, hogy a lemezfájl Linux rendszerű virtuális géphez tartozik-e, ha meg van adva; vagy Windows rendszeren, ha nincs megadva alapértelmezés szerint.

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

-Location

Megadja a virtuális gép helyét.

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

-Name

A virtuálisgép-erőforrás neve.

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

-OpenPorts

A létrehozott virtuális gép hálózati biztonsági csoportján (NSG) megnyitandó portok listája. Az alapértelmezett érték a választott kép típusától függ (például Windows: 3389, 5985 és Linux: 22).

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

-PublicIpAddressName

A létrehozott virtuális gép új (vagy meglévő) nyilvános IP-címének neve. Ha nincs megadva, a rendszer létrehoz egy nevet.

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

-ResourceGroupName

Egy erőforráscsoport nevét adja meg.

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

-SecurityGroupName

A létrehozott virtuális gép új (vagy meglévő) hálózati biztonsági csoportjának (NSG) neve. Ha nincs megadva, a rendszer létrehoz egy nevet.

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

-Size

A virtuális gép mérete. Az alapértelmezett érték: Standard_DS1_v2.

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

-SubnetAddressPrefix

A virtuális géphez létrehozandó alhálózat címelőtagja.

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

-SubnetName

A létrehozott virtuális gép új (vagy meglévő) alhálózatának neve. Ha nincs megadva, a rendszer létrehoz egy nevet.

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

-SystemAssignedIdentity

Ha a paraméter jelen van, a virtuális géphez egy automatikusan létrehozott felügyelt rendszeridentitás lesz hozzárendelve.

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

-Tag

Megadja, hogy az erőforrások és az erőforráscsoportok név-érték párokkal címkézhetők-e. Ha címkéket ad hozzá az erőforrásokhoz, az erőforrásokat az erőforráscsoportok között csoportosíthatja, és saját nézeteket hozhat létre. Minden erőforrás vagy erőforráscsoport legfeljebb 15 címkével rendelkezhet.

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

-UserAssignedIdentity

A virtuális géphez hozzárendelendő felügyeltszolgáltatás-identitás neve.

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

-VirtualNetworkName

A létrehozott virtuális gép új (vagy meglévő) virtuális hálózatának neve. Ha nincs megadva, a rendszer létrehoz egy nevet.

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

-VM

Egy létrehozandó helyi virtuális gépet határoz meg. Virtuálisgép-objektum beszerzéséhez használja a New-AzureRmVMConfig parancsmagot. A virtuális gép konfigurálásához más parancsmagok is használhatók, például a Set-AzureRmVMOperatingSystem, a Set-AzureRmVMSourceImage és az Add-AzureRmVMNetworkInterface.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

-Zone

Megadja a virtuális gép zónalistáját.

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

Bevitelek

String

PSVirtualMachine

String[]

Hashtable

Kimenetek

PSAzureOperationResponse