New-AzVM

模組:: Az.Compute Module

建立虛擬機器。

語法

SimpleParameterSet (預設值)

New-AzVM
    [[-ResourceGroupName] <String>]
    [[-Location] <String>]
    [[-Zone] <String[]>]
    -Name <String>
    -Credential <PSCredential>
    [-EdgeZone <String>]
    [-PublicIpSku <String>]
    [-NetworkInterfaceDeleteOption <String>]
    [-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]
    [-OSDiskDeleteOption <String>]
    [-DataDiskSizeInGb <Int32[]>]
    [-DataDiskDeleteOption <String>]
    [-EnableUltraSSD]
    [-ProximityPlacementGroupId <String>]
    [-HostId <String>]
    [-VmssId <String>]
    [-Priority <String>]
    [-EvictionPolicy <String>]
    [-MaxPrice <Double>]
    [-EncryptionAtHost]
    [-HostGroupId <String>]
    [-SshKeyName <String>]
    [-GenerateSshKey]
    [-CapacityReservationGroupId <String>]
    [-UserData <String>]
    [-ImageReferenceId <String>]
    [-PlatformFaultDomain <Int32>]
    [-HibernationEnabled]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-DiskControllerType <String>]
    [-SharedGalleryImageId <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-SshKeyType <String>]
    [-ZonePlacementPolicy <String>]
    [-IncludeZone <String[]>]
    [-ExcludeZone <String[]>]
    [-AlignRegionalDisksToVMZone]
    [-EnableProxyAgent]
    [-AddProxyAgentExtension]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DefaultParameterSet

New-AzVM
    [-ResourceGroupName] <String>
    [-Location] <String>
    [-VM] <PSVirtualMachine>
    [[-Zone] <String[]>]
    [-EdgeZone <String>]
    [-DisableBginfoExtension]
    [-Tag <Hashtable>]
    [-LicenseType <String>]
    [-AsJob]
    [-OSDiskDeleteOption <String>]
    [-DataDiskDeleteOption <String>]
    [-SshKeyName <String>]
    [-GenerateSshKey]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DiskFileParameterSet

New-AzVM
    [[-ResourceGroupName] <String>]
    [[-Location] <String>]
    -Name <String>
    -DiskFile <String>
    [-EdgeZone <String>]
    [-PublicIpSku <String>]
    [-NetworkInterfaceDeleteOption <String>]
    [-VirtualNetworkName <String>]
    [-AddressPrefix <String>]
    [-SubnetName <String>]
    [-SubnetAddressPrefix <String>]
    [-PublicIpAddressName <String>]
    [-DomainNameLabel <String>]
    [-AllocationMethod <String>]
    [-SecurityGroupName <String>]
    [-OpenPorts <Int32[]>]
    [-Linux]
    [-Size <String>]
    [-AvailabilitySetName <String>]
    [-SystemAssignedIdentity]
    [-UserAssignedIdentity <String>]
    [-AsJob]
    [-OSDiskDeleteOption <String>]
    [-DataDiskSizeInGb <Int32[]>]
    [-DataDiskDeleteOption <String>]
    [-EnableUltraSSD]
    [-ProximityPlacementGroupId <String>]
    [-HostId <String>]
    [-VmssId <String>]
    [-Priority <String>]
    [-EvictionPolicy <String>]
    [-MaxPrice <Double>]
    [-EncryptionAtHost]
    [-HostGroupId <String>]
    [-CapacityReservationGroupId <String>]
    [-UserData <String>]
    [-PlatformFaultDomain <Int32>]
    [-HibernationEnabled]
    [-vCPUCountAvailable <Int32>]
    [-vCPUCountPerCore <Int32>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-AzVM Cmdlet 會在 Azure 中建立虛擬機器。此 Cmdlet 會採用虛擬機器物件作為輸入。 New-AzVM Cmdlet 會建立新的儲存體帳戶，以進行開機診斷（如果尚未存在）。

使用 New-AzVMConfig Cmdlet 來建立虛擬機器物件。
然後使用下列 Cmdlet 來設定虛擬機器物件的不同屬性：

Add-AzVMNetworkInterface 來設定網路設定檔。
Set-AzVMOperatingSystem 來設定 OS 設定檔。
Set-AzVMSourceImage 來設定來源映像。
Set-AzVMOSDisk 來設定 OS 磁碟（儲存體配置檔）。
Get-AzComputeResourceSku 也可用來找出訂用帳戶和區域的可用虛擬機器大小。

提供 SimpleParameterSet 一種方便的方法，透過將通用 VM 建立引數設為選擇性來建立 VM。

如需教學課程，請參閱快速入門：使用 PowerShell 在 Azure 中建立 Windows 虛擬機器。

範例

範例 1：建立虛擬機器

New-AzVM -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

此範例指令碼顯示如何建立虛擬機器。指令碼會詢問 VM 的使用者名稱和密碼。此腳本會使用數個其他 Cmdlet。

範例 2：從自訂使用者映像建立虛擬機器

## VM Account
# Credentials for Local Admin account you created in the sysprepped (generalized) vhd image
$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -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-AzVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$PIP = New-AzPublicIpAddress -Name $PublicIPAddressName -DomainNameLabel $DNSNameLabel -ResourceGroupName $ResourceGroupName -Location $LocationName -AllocationMethod Dynamic
$NIC = New-AzNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id -PublicIpAddressId $PIP.Id

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

$securityTypeStnd = "Standard"
$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $VMSize -SecurityType $securityTypeStnd
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name $OSDiskName -VhdUri $OSDiskUri -SourceImageUri $SourceImageUri -Caching $OSDiskCaching -CreateOption $OSCreateOption -Windows

New-AzVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose -Zone @("1")

此範例會採用現有的系統準備、一般化自訂作業系統映像，並將資料磁碟附加至該映像、佈建新的網路、部署 VHD，然後執行它。此腳本可用於自動布建，因為它會使用內嵌本機虛擬機器系統管理員認證，而不是呼叫需要使用者互動的 Get-Credential 。此文稿假設您已登入 Azure 帳戶。您可以使用 Get-AzSubscription Cmdlet 來確認您的登入狀態。

範例 3：從沒有公用 IP 的市集映像建立 VM

$VMLocalAdminUser = "LocalAdminUser"
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -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-AzVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $SubnetAddressPrefix
$Vnet = New-AzVirtualNetwork -Name $NetworkName -ResourceGroupName $ResourceGroupName -Location $LocationName -AddressPrefix $VnetAddressPrefix -Subnet $SingleSubnet
$NIC = New-AzNetworkInterface -Name $NICName -ResourceGroupName $ResourceGroupName -Location $LocationName -SubnetId $Vnet.Subnets[0].Id

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

$VirtualMachine = New-AzVMConfig -VMName $VMName -VMSize $VMSize
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'WindowsServer' -Skus '2022-datacenter-azure-edition-core' -Version latest

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

此命令會從沒有公用 IP 的市集映像建立 VM。

範例 4：建立具有 UserData 值的 VM：

# VM Account
$VMLocalAdminUser = "LocalAdminUser";
$VMLocalAdminSecurePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;

# Azure Account
$LocationName = "eastus";
$ResourceGroupName = "MyResourceGroup";

# VM Profile & Hardware
$VMName = 'v' + $ResourceGroupName;
$domainNameLabel = "d1" + $ResourceGroupName;
$Credential = New-Object System.Management.Automation.PSCredential ($VMLocalAdminUser, $VMLocalAdminSecurePassword);

# Create UserData value
$text = "text for UserData";
$bytes = [System.Text.Encoding]::Unicode.GetBytes($text);
$userData = [Convert]::ToBase64String($bytes);

# Create VM
New-AzVM -ResourceGroupName $ResourceGroupName -Name $VMName -Credential $Credential -DomainNameLabel $domainNameLabel -UserData $userData;
$vm = Get-AzVM -ResourceGroupName $ResourceGroupName -Name $VMName -UserData;

UserData 值必須一律以 Base64 編碼。

範例 5：在另一個資源群組中使用現有子網路建立新的 VM

$UserName = "User"
$Password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$psCred = New-Object System.Management.Automation.PSCredential($UserName, $Password)

$Vnet = $(Get-AzVirtualNetwork -ResourceGroupName ResourceGroup2 -Name VnetName)
$PIP = (Get-AzPublicIpAddress -ResourceGroupName ResourceGroup2 -Name PublicIPName)

$NIC = New-AzNetworkInterface -Name NICname -ResourceGroupName ResourceGroup2 -Location SouthCentralUS -SubnetId $Vnet.Subnets[1].Id -PublicIpAddressId $PIP.Id
$VirtualMachine = New-AzVMConfig -VMName VirtualMachineName -VMSize Standard_D4s_v3
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName computerName -Credential $psCred -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName 'MicrosoftWindowsServer' -Offer 'WindowsServer' -Skus '2022-datacenter-azure-edition-core' -Version latest
New-AzVM -ResourceGroupName ResourceGroup1 -Location SouthCentralUS -VM $VirtualMachine

此範例會從市集部署 Windows VM，在一個資源群組中部署現有的子網。

範例 6：建立新的 VM 作為具有 PlatformFaultDomain 值的 VMSS 的一部分。

$resourceGroupName= "ResourceGroupName";
$loc = 'eastus';
New-AzResourceGroup -Name $resourceGroupName -Location $loc -Force;

$domainNameLabel = "d1" + $resourceGroupName;
$vmname = "vm" + $resourceGroupName;
$platformFaultDomainVMDefaultSet = 2;
$vmssFaultDomain = 3;
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <USERNAME>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vmssName = "vmss" + $resourceGroupName;

$vmssConfig = New-AzVmssConfig -Location $loc -PlatformFaultDomainCount $vmssFaultDomain;
$vmss = New-AzVmss -ResourceGroupName $resourceGroupName -Name $vmssName -VirtualMachineScaleSet $vmssConfig;

$vm = New-AzVM -ResourceGroupName $resourceGroupName -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -PlatformFaultDomain $platformFaultDomainVMDefaultSet -VmssId $vmss.Id;

此範例會建立新的 VM 作為具有 PlatformFaultDomain 值的 VMSS 的一部分。

範例 7：使用 -Image 別名建立 VM。

$resourceGroupName= "<Resource Group Name>"
$loc = "<Azure Region>"
$domainNameLabel = "<Domain Name Label>"
$vmname = "<Virtual Machine Name>"
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$user = "<Username>"
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword)

New-AzResourceGroup -Name $resourceGroupName -Location $loc -Force

# Create a VM using an Image alias.
$vmname = 'v' + $resourceGroupName
$domainNameLabel = "d" + $resourceGroupName
$vm = New-AzVM -ResourceGroupName $resourceGroupName -Name $vmname -Credential $cred -Image OpenSuseLeap154Gen2 -DomainNameLabel $domainNameLabel

$vm = Get-AzVM -ResourceGroupName $resourceGroupName -Name $vmname

此範例會使用 -Image 參數建立新的虛擬機器，為虛擬機器提供許多預設值。

範例 8：建立 Trusted Launch SecurityType 的 VM。

$rgname = <Resource Group Name>;
$loc = "eastus";

New-AzResourceGroup -Name $rgname -Location $loc -Force;
# VM Profile & Hardware
$domainNameLabel1 = 'd1' + $rgname;
$vmsize = 'Standard_D4s_v3';
$vmname1 = 'v' + $rgname;
$imageName = "Win2022AzureEdition";
$disable = $false;
$enable = $true;
$securityType = "TrustedLaunch";

$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);

# VM creation using Simple parameterset
New-AzVM -ResourceGroupName $rgname -Location $loc -Name $vmname1 -Credential $cred -Size $vmsize -Image $imageName -DomainNameLabel $domainNameLabel1 -SecurityType $securityType;
$vm1 = Get-AzVM -ResourceGroupName $rgname -Name $vmname1;

# Verify Values
#$vm1.SecurityProfile.SecurityType "TrustedLaunch";
#$vm1.SecurityProfile.UefiSettings.VTpmEnabled $true;
#$vm1.SecurityProfile.UefiSettings.SecureBootEnabled $true;

此範例會建立具有 TrustedLaunch 安全性類型的新 VM，並預設將旗標 EnableSecureBoot 和 EnableVtpm 設定為 True。受信任啟動 VM 需要 Gen2 映像。請查看 Trusted Launch 功能頁面以取得更多資訊。

範例 9：使用 New-AzVMConfig 建立預設開啟信任啟動的 VM。

$rgname = "<Resource Group Name>";
$loc = "<Azure Region>";
$vmname = 'vm' + $rgname;
$domainNameLabel = "d1" + $rgname;
$vnetname = "vn" + $rgname;
$vnetAddress = "10.0.0.0/16";
$subnetname = "slb" + $rgname;
$subnetAddress = "10.0.2.0/24";
$OSDiskName = $vmname + "-osdisk";
$NICName = $vmname+ "-nic";
$NSGName = $vmname + "-NSG";
$OSDiskSizeinGB = 128;
$VMSize = "Standard_DS2_v2";
$PublisherName = "MicrosoftWindowsServer";
$Offer = "WindowsServer";
$SKU = "2022-datacenter-azure-edition";
$version = "latest";
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
# Network setup
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name $subnetname -AddressPrefix $subnetAddress;
$vnet = New-AzVirtualNetwork -Name $vnetname -ResourceGroupName $rgname -Location $loc -AddressPrefix $vnetAddress -Subnet $frontendSubnet;
$nsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name RDP  -Protocol Tcp  -Direction Inbound -Priority 1001 -SourceAddressPrefix * -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389 -Access Allow;
$nsg = New-AzNetworkSecurityGroup -ResourceGroupName $RGName -Location $loc -Name $NSGName  -SecurityRules $nsgRuleRDP;
$nic = New-AzNetworkInterface -Name $NICName -ResourceGroupName $RGName -Location $loc -SubnetId $vnet.Subnets[0].Id -NetworkSecurityGroupId $nsg.Id -EnableAcceleratedNetworking;
# VM
$vmConfig = New-AzVMConfig -VMName $vmName -VMSize $VMSize;
Set-AzVMOperatingSystem -VM $vmConfig -Windows -ComputerName $vmName -Credential $cred;
Set-AzVMSourceImage -VM $vmConfig -PublisherName $PublisherName -Offer $Offer -Skus $SKU -Version $version ;
Add-AzVMNetworkInterface -VM $vmConfig -Id $nic.Id;
New-AzVM -ResourceGroupName $rgname -Location $loc -VM $vmConfig;
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmname;
# Verify $vm.SecurityProfile.SecurityType is TrustedLaunch
# Verify $vm.SecurityProfile.UefiSettings.SecureBootEnabled is true.
# Verify $vm.SecurityProfile.UefiSettings.VTpmEnabled is true.

此範例示範如何使用有效的 Gen2 映像建立 VM，讓 VM 預設為需要 Gen2 映像的 TrustedLaunch。請查看 Trusted Launch 功能頁面以取得更多資訊。

範例 10：建立預設開啟 TrustedLaunch 的 VM。

$rgname = "<Resource Group Name>";
$loc = "<Azure Region>";
$vmname = 'vm' + $rgname;
$domainNameLabel = "d1" + $rgname;
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = <Username>;
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
# Create VM
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel;
$vm = Get-AzVM -ResourceGroupName $rgname -Name $vmname;
# Verify $vm.SecurityProfile.SecurityType is TrustedLaunch.
# Verify the $vm.StorageProfile.ImageReference.Sku has defaulted to "2022-datacenter-azure-edition", a Gen2 image.

此範例示範具有最小參數的簡單 Cmdlet 呼叫如何導致具有 Gen2 映像的已啟用 TrustedLaunch 的 VM。請查看 Trusted Launch 功能頁面以取得更多資訊。

=======

參數

-AddProxyAgentExtension

指定是否隱含地安裝 ProxyAgent 延伸模組。此選項目前僅適用於 Linux 作業系統。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-AddressPrefix

將針對 VM 建立之虛擬網路的位址前置詞。

參數屬性

類型:	String
預設值:	192.168.0.0/16
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AlignRegionalDisksToVMZone

指定區域磁碟是否應該對齊/移至 VM 區域。這僅適用於已設定放置屬性的 VM。請注意，這項變更無法復原。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllocationMethod

將為 VM 建立之公用 IP 的 IP 配置方法。

參數屬性

類型:	String
預設值:	Static
接受的值:	Static, Dynamic
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AsJob

在背景中執行 Cmdlet，並傳回作業以追蹤進度。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AvailabilitySetName

指定可用性設定組的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CapacityReservationGroupId

用來配置之容量保留群組的識別碼。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

VM 的系統管理員認證。

使用者名稱
䋰：
Windows：不能包含特殊字元 /“”[]：|<>+=;，？*@& 或以 “.” 結尾
Linux：使用者名稱只能包含字母、數字、連字號和底線，並且不能以連字號或數字開頭。
不允許的值： “administrator”、“admin”、“user”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0”、“sys”、“test2”、“test3”、“user4”、“user5”。
最小長度： 1 個字元
最大長度： Windows 為 20 個字符，Linux 為 64 個字符

密碼
必須包含以下 3 個：1 個小寫字元、1 個大寫字元、1 個數字和 1 個特殊字元。
此值的長度必須介於 12 到 123 個字元之間。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DataDiskDeleteOption

指定 VM 刪除後的資料磁碟刪除選項。選項包括分離、刪除

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DataDiskSizeInGb

指定資料磁碟的大小（以 GB 為單位）。

參數屬性

類型:	Int32[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisableBginfoExtension

表示此 Cmdlet 不會在虛擬機器上安裝 BG 資訊 延伸模組。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DefaultParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DiskControllerType

指定為 VM 和 VirtualMachineScaleSet 設定的磁碟控制器類型。只有作業系統磁碟和 VM SKU 支援第 2 代（https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2）的虛擬機器才支援此屬性，請檢查 Microsoft 回應中傳回的 HyperVGenerations 功能，作為 VM SKU 功能的一部分。區域的計算 SKU API 包含 V2 （https://learn.microsoft.com/rest/api/compute/resourceskus/list）。
如需支援的磁碟控制器類型詳細資訊，請參閱 https://aka.ms/azure-diskcontrollertypes。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DiskFile

要上傳至雲端並建立 VM 的虛擬硬碟檔案本機路徑，其尾碼必須為 '.vhd'。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DiskFileParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DomainNameLabel

VM 完整網域名稱（FQDN）的子網域標籤。這將採用 {domainNameLabel}.{location}.cloudapp.azure.com的形式。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EdgeZone

設定邊緣區域名稱。如果設定，查詢將路由傳送至指定的邊緣區域，而不是主要區域。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EnableProxyAgent

指定是否應啟用中繼資料安全通訊協定（ProxyAgent）特性。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EnableSecureBoot

指定是否應在虛擬機上啟用安全開機。

參數屬性

類型:	Nullable<T>[Boolean]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EnableUltraSSD

針對 VM 使用 UltraSSD 磁碟。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EnableVtpm

指定是否應在虛擬機上啟用 vTPM。

參數屬性

類型:	Nullable<T>[Boolean]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-EncryptionAtHost

使用者可以在要求中使用 EncryptionAtHost 屬性來啟用或停用虛擬機器或虛擬機器擴展集的主機加密。這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。默認值：除非資源將此屬性設定為 true，否則將會停用主機的加密。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EvictionPolicy

Azure Spot 虛擬機器的收回原則。支援的值為 'Dealocate' 和 'Delete'。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExcludeZone

此屬性補充 'zonePlacementPolicy' 屬性。如果 'zonePlacementPolicy' 設定為 'Any'，系統選取的可用性區域不得出現在以 'excludeZones' 傳遞的可用性區域清單中。如果未提供『excludeZones』，則會考慮區域中的所有可用性區域以供選取。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-GenerateSshKey

產生 SSH 公開/私密金鑰組，並在 Azure 上建立 SSH 公開金鑰資源。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DefaultParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-HibernationEnabled

啟用或停用 VM 上休眠功能的旗標。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-HostGroupId

指定虛擬機器將所在的專用主機群組。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-HostId

主機的 ID

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IfMatch

用於對 PUT 和其他非安全方法設定請求條件。只有在資源符合列出的其中一個 ETag 值時，伺服器才會傳回所要求的資源。請省略此值以一律覆寫目前的資源。指定最後看到的 ETag 值，以防止意外覆寫並行變更。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-IfNoneMatch

用來讓 GET 和 HEAD 方法的請求有條件。只有在列出的 ETag 值都不符合目前實體時，伺服器才會傳回所要求的資源。用來讓 GET 和 HEAD 方法的請求有條件。只有在列出的 ETag 值都不符合目前實體時，伺服器才會傳回所要求的資源。設定為 '*' 以允許建立新的記錄集，但會防止更新現有的記錄集。其他值會導致伺服器發生錯誤，因為它們不受支援。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Image

將建置 VM 的易記映像名稱。可用的別名包括：Win2022AzureEdition、Win2022AzureEditionCore、Win2019Datacenter、Win2016Datacenter、Win2012R2Datacenter、Win2012Datacenter、Ubuntu2204、CentOS85Gen2、Debian11、OpenSuseLeap154Gen2、RHELRaw8LVMGen2、SuseSles15SP3、FlatcarLinuxFreeGen2。

參數屬性

類型:	String
預設值:	Win2016Datacenter
支援萬用字元:	False
不要顯示:	False
別名:	圖片名稱

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ImageReferenceId

指定 vm 部署的共享資源庫映像唯一標識碼。這可以從共用資源庫映像 GET 呼叫擷取。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IncludeZone

此屬性補充 'zonePlacementPolicy' 屬性。如果 'zonePlacementPolicy' 設定為 'Any'，系統選取的可用性區域必須出現在以 'includeZones' 傳遞的可用性區域清單中。如果未提供『includeZones』，則會考慮區域中的所有可用性區域以供選取。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LicenseType

指定授權類型，表示虛擬機器的映像或磁碟已在內部部署獲得授權。 Windows Server 的可能值包括：

Windows_Client
Windows_Server

Linux Server 作業系統的可能值為：

RHEL_BYOS （適用於 RHEL）
SLES_BYOS （適用於 SUSE）

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DefaultParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Linux

指出磁碟檔案是否適用於 Linux VM（如果已指定）;或 Windows（如果預設未指定）。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

指定虛擬機器的位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	1
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	1
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaxPrice

低優先順序虛擬機器計費的最高價格。

參數屬性

類型:	Double
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

VM 資源的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NetworkInterfaceDeleteOption

指定刪除 VM 時要對 NetworkInterface 資源執行的動作。選項包括：分離、刪除。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OpenPorts

要在已建立 VM 的網路安全性群組（NSG）上開啟的連接埠清單。預設值取決於所選映像類型（即 Windows：3389、5985 和 Linux：22）。

參數屬性

類型:	Int32[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-OSDiskDeleteOption

指定 VM 刪除之後的 OS 磁碟刪除選項。選項包括分離、刪除

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PlatformFaultDomain

指定虛擬機器的容錯網域。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Priority

虛擬機器的優先順序。僅支援的值為「Regular」、「Spot」和「Low」。「Regular」適用於一般虛擬機器。「Spot」是 Spot 虛擬機器。「低」也適用於 Spot 虛擬機器，但會由「Spot」取代。請使用「現貨」而不是「低」。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProximityPlacementGroupId

要與此虛擬機器搭配使用的鄰近放置群組的資源識別碼。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	鄰近放置群組

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PublicIpAddressName

要使用之新（或現有）公用 IP 位址的名稱。如果未指定，則會產生名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PublicIpSku

指定公用 IP SKU 名稱

接受的值為「基本」和「標準」

參數屬性

類型:	String
預設值:	Standard
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

指定資源群組的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	0
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	0
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SecurityGroupName

要使用之新（或現有）網路安全性群組（NSG）的名稱。如果未指定，則會產生名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SecurityType

指定虛擬機的 SecurityType。它必須設定為任何指定的值，才能啟用 UefiSettings。根據預設，除非設定此屬性，否則不會啟用 UefiSettings。

參數屬性

類型:	String
預設值:	None
接受的值:	TrustedLaunch, ConfidentialVM, Standard
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SharedGalleryImageId

指定 vm 部署的共享資源庫映像唯一標識碼。這可以從共用資源庫映像 GET 呼叫擷取。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Size

虛擬機器大小。 Get-AzComputeResourceSku 可用來找出訂用帳戶和區域的可用大小。
預設值為：Standard_D2s_v3。

參數屬性

類型:	String
預設值:	Standard_D2s_v3
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SshKeyName

SSH 公開金鑰資源的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DefaultParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SshKeyType

指定要產生的 SSH 金鑰類型。允許的值為 'Ed25519' 和 'RSA'。

參數屬性

類型:	String
預設值:	None
接受的值:	Ed25519, RSA
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubnetAddressPrefix

將為 VM 建立之子網路的位址前置詞。

參數屬性

類型:	String
預設值:	192.168.1.0/24
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubnetName

要使用之新（或現有）子網路的名稱，供所建立的 VM 使用。如果未指定，則會產生名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SystemAssignedIdentity

如果參數存在，則會指派自動產生的受管理系統身分識別給 VM。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tag

指定資源和資源群組可以使用一組名稱值配對來標記。將標籤新增至資源可讓您跨資源群組將資源分組在一起，並建立自己的檢視。每個資源或資源群組最多可以有 15 個標籤。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DefaultParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-UserAssignedIdentity

應該指派給 VM 的受控服務身分識別名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UserData

UserData，將以 base-64 編碼。客戶不應在此傳遞任何秘密。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-vCPUCountAvailable

指定 VM 可用的 vCPU 數目。當要求本文中未指定此屬性時，預設行為是將它設定為 api 回應中公開的 vCPU 值，列出區域中所有可用的虛擬機大小。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-vCPUCountPerCore

指定 vCPU 與實體核心比率。當要求本文中未指定此屬性時，預設行為會針對 api 回應中公開的 VM 大小設定為 vCPUUsPerCore 的值，列出區域中所有可用的虛擬機大小，。將此屬性設定為 1 也表示已停用超線程處理。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-VirtualNetworkName

要讓所建立 VM 使用的新（或現有）虛擬網路名稱。如果未指定，則會產生名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-VM

指定要建立的本機虛擬機器。若要取得虛擬機器物件，請使用 New-AzVMConfig Cmdlet。其他 Cmdlet 可用來設定虛擬機器，例如 Set-AzVMOperatingSystem、Set-AzVMSourceImage 和 Add-AzVMNetworkInterface。

參數屬性

類型:	PSVirtualMachine
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	VMProfile

參數集

DefaultParameterSet

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-VmssId

此 VM 將與之相關聯的虛擬機器擴展集識別碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DiskFileParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Zone

指定虛擬機器的區域。雖然它會採用區域陣列，但虛擬機器不支援多個可用性區域。允許的值取決於區域的功能。允許的值通常為 1、2 或 3。 Azure 可用性區域的詳細資訊。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	3
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ZonePlacementPolicy

指定虛擬機在可用性區域中放置的原則。可能的值為：任何 - 可用性區域會自動由系統挑選，作為虛擬機建立的一部分。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

SimpleParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

共用方式為

New-AzVM

語法

SimpleParameterSet (預設值)

DefaultParameterSet

DiskFileParameterSet

Description

範例

範例 1：建立虛擬機器

範例 2：從自訂使用者映像建立虛擬機器

範例 3：從沒有公用 IP 的市集映像建立 VM

範例 4：建立具有 UserData 值的 VM：

範例 5：在另一個資源群組中使用現有子網路建立新的 VM

範例 6：建立新的 VM 作為具有 PlatformFaultDomain 值的 VMSS 的一部分。

範例 7：使用 -Image 別名建立 VM。

範例 8：建立 Trusted Launch SecurityType 的 VM。

範例 9：使用 New-AzVMConfig 建立預設開啟信任啟動的 VM。

範例 10：建立預設開啟 TrustedLaunch 的 VM。

參數

-AddProxyAgentExtension

參數屬性

參數集

-AddressPrefix

參數屬性

參數集

-AlignRegionalDisksToVMZone

參數屬性

參數集

-AllocationMethod

參數屬性

參數集

-AsJob

參數屬性

參數集

-AvailabilitySetName

參數屬性

參數集

-CapacityReservationGroupId

參數屬性

參數集

-Confirm

參數屬性

參數集

-Credential

參數屬性

參數集

-DataDiskDeleteOption

參數屬性

參數集

-DataDiskSizeInGb

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DisableBginfoExtension

參數屬性

參數集

-DiskControllerType

參數屬性

參數集

-DiskFile

參數屬性

參數集

-DomainNameLabel

參數屬性

參數集

-EdgeZone

參數屬性

參數集

-EnableProxyAgent

參數屬性

參數集

-EnableSecureBoot

參數屬性

參數集

-EnableUltraSSD

參數屬性

參數集

-EnableVtpm