New-AzNetworkCloudVirtualMachine

模組:

Az.NetworkCloud

建立新的虛擬機，或更新現有虛擬機的屬性。

語法

New-AzNetworkCloudVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -AdminUsername <String>
   -CloudServiceNetworkAttachmentAttachedNetworkId <String>
   -CloudServiceNetworkAttachmentIPAllocationMethod <VirtualMachineIPAllocationMethod>
   -CpuCore <Int64>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -Location <String>
   -MemorySizeGb <Int64>
   -OSDiskSizeGb <Int64>
   -VMImage <String>
   [-BootMethod <VirtualMachineBootMethod>]
   [-CloudServiceNetworkAttachmentDefaultGateway <DefaultGateway>]
   [-CloudServiceNetworkAttachmentIpv4Address <String>]
   [-CloudServiceNetworkAttachmentIpv6Address <String>]
   [-CloudServiceNetworkAttachmentName <String>]
   [-IsolateEmulatorThread <VirtualMachineIsolateEmulatorThread>]
   [-NetworkAttachment <INetworkAttachment[]>]
   [-NetworkData <String>]
   [-OSDiskCreateOption <OSDiskCreateOption>]
   [-OSDiskDeleteOption <OSDiskDeleteOption>]
   [-PlacementHint <IVirtualMachinePlacementHint[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-StorageProfileVolumeAttachment <String[]>]
   [-Tag <Hashtable>]
   [-UserData <String>]
   [-VMDeviceModel <VirtualMachineDeviceModelType>]
   [-VMImageRepositoryCredentialsPassword <SecureString>]
   [-VMImageRepositoryCredentialsRegistryUrl <String>]
   [-VMImageRepositoryCredentialsUsername <String>]
   [-VirtioInterface <VirtualMachineVirtioInterfaceType>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立新的虛擬機，或更新現有虛擬機的屬性。

範例

範例 1：建立虛擬機

$networkAttachment = @{
    AttachedNetworkId = "attachedNetworkID"
    IpAllocationMethod = "Dynamic"
}
$hint = @{
    HintType = "Affinity"
    SchedulingExecution = "schedulingExecution"
    Scope = "scope"
    ResourceId = "resourceId"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}

$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudVirtualMachine -Name vmName  -ResourceGroupName resourceGroup -AdminUsername adminUsername -CloudServiceNetworkAttachmentAttachedNetworkId csnAttachedNetworkId -CloudServiceNetworkAttachmentIPAllocationMethod ipAllocationMethod -CpuCore cpuCore -ExtendedLocationName extendedLocationName -ExtendedLocationType "Custom" -Location location -SubscriptionId subscriptionId -MemorySizeGb memorySizeGb -OSDiskSizeGb osDiskSizeGb -VMImage vmImage -BootMethod bootMethod -CloudServiceNetworkAttachmentDefaultGateway defaultGateway -CloudServiceNetworkAttachmentName csnAttachmentName -IsolateEmulatorThread isolateEmulatorThread -NetworkAttachment $networkAttachment -NetworkData networkData -OSDiskCreateOption osDiskCreationOption -OSDiskDeleteOption osDiskDeleteOption -PlacementHint $hint -SshPublicKey $sshPublicKey -Tag @{tags = "tags"} -UserData userData -VirtioInterface virtioInterface -VMDeviceModel vmDeviceModel -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $securePassword -VMImageRepositoryCredentialsRegistryUrl registryUrl

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataL
                                                                                                                                                  astModified
                                                                                                                                                  ByType
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             -----------
eastus   default 7/07/2023 21:32:03 <user>                 User                    07/07/2023 21:32:41      <identity>                           Application

此命令會建立虛擬機。

參數

-AdminUsername

將 SSH 公鑰新增至授權金鑰的系統管理員名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BootMethod

選取虛擬機的開機方法。

類型:	VirtualMachineBootMethod
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentAttachedNetworkId

連結至虛擬機之相關聯網路的資源標識碼。它可以是 cloudServicesNetwork、l3Network、l2Network 或主幹網路資源之一。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentDefaultGateway

這是否為預設閘道的指標。單一計算機的其中一個連結網路（包括 CloudServicesNetwork 附件）只能指定為 True。

類型:	DefaultGateway
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentIPAllocationMethod

虛擬機的IP配置機制。動態和靜態僅適用於 l3Network，也可能指定 Disabled。否則，Disabled 是唯一允許的值。

類型:	VirtualMachineIPAllocationMethod
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentIpv4Address

虛擬機的 IPv4 位址。只有當連結的網路具有 IPV4 或 DualStack 的 IPAllocationType 時，才會使用此欄位。如果 IPAllocationMethod 是：Static - 此欄位必須包含使用者指定的 IPv4 位址，該地址必須來自連結網路中指定的子網內。動態 - 此欄位是唯讀的，但會從連結網路中指定的子網內填入位址。已停用 - 此欄位會是空的。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentIpv6Address

虛擬機的 IPv6 位址。只有當連結的網路具有 IPV6 或 DualStack 的 IPAllocationType 時，才會使用此字段。如果 IPAllocationMethod 是：Static -此欄位必須包含從附加網路所指定範圍內的 IPv6 位址範圍。動態 - 此欄位是唯讀的，但會從連結網路中指定的子網內填入範圍。已停用 - 此欄位會是空的。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloudServiceNetworkAttachmentName

相關聯的網路介面名稱。如果指定，網路附件名稱的長度上限為 15 個字元，而且此虛擬機必須是唯一的。如果使用者未指定此值，則會使用網路資源的預設介面名稱。針對 CloudServicesNetwork 資源，將會忽略此名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

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

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CpuCore

虛擬機中的 CPU 核心數目。

類型:	Int64
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationName

要在其中建立資源之擴充位置的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationType

擴充位置類型，例如 CustomLocation。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-IsolateEmulatorThread

欄位已被取代，如果提供，則會忽略此值。 指出是否隔離其中一個指定的CPU核心，以執行此虛擬機的模擬器線程。

類型:	VirtualMachineIsolateEmulatorThread
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

資源所在的地理位置

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MemorySizeGb

虛擬機的記憶體大小。 配置會以 Gibibytes 來測量。

類型:	Int64
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Name

虛擬機的名稱。

類型:	String
別名:	VirtualMachineName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NetworkAttachment

虛擬機的網路附件清單。 若要建構，請參閱 NETWORKATTACHMENT 屬性和建立哈希表的 NOTES 一節。

類型:	INetworkAttachment[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NetworkData

Base64 編碼的 cloud-init 網路數據。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OSDiskCreateOption

建立OS磁碟的策略。

類型:	OSDiskCreateOption
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OSDiskDeleteOption

刪除 OS 磁碟的策略。

類型:	OSDiskDeleteOption
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OSDiskSizeGb

磁碟的大小。 如果 createOption 為暫時，則為必要項。 配置會以 Gibibytes 來測量。

類型:	Int64
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PlacementHint

虛擬機的排程提示。 若要建構，請參閱 PLACEMENTHINT 屬性的 NOTES 區段並建立哈希表。

類型:	IVirtualMachinePlacementHint[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。 名稱不區分大小寫。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SshPublicKey

ssh 公鑰清單。 系統會使用 adminUsername 的 cloud-init ssh_authorized_keys機制，將每個密鑰新增至虛擬機。 若要建構，請參閱 SSHPUBLICKEY 屬性的 NOTES 區段並建立哈希表。

類型:	ISshPublicKey[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StorageProfileVolumeAttachment

要求連結至虛擬機之磁碟區的資源標識碼。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

目標訂用帳戶的標識碼。 此值必須是 UUID。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

資源標籤。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserData

Base64 編碼的 cloud-init 用戶數據。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtioInterface

欄位已被取代，請改用 virtualizationModel。 virtio 介面的類型。

類型:	VirtualMachineVirtioInterfaceType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMDeviceModel

要使用的裝置型號類型。

類型:	VirtualMachineDeviceModelType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMImage

目前布建至 OS 磁碟的虛擬機映射，使用用來提取映射的完整 URL 和標記表示法。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-VMImageRepositoryCredentialsPassword

用來存取目標存放庫中映像的密碼或令牌。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMImageRepositoryCredentialsRegistryUrl

用來驗證存放庫認證的驗證伺服器的URL。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMImageRepositoryCredentialsUsername

用來存取目標存放庫中映像的用戶名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

IVirtualMachine