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>]

説明

新しい仮想マシンを作成するか、既存の仮想マシンのプロパティを更新します。

例

例 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
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AsJob

コマンドをジョブとして実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BootMethod

仮想マシンのブート方法を選択します。

型:	VirtualMachineBootMethod
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentAttachedNetworkId

仮想マシンに接続されている関連付けられているネットワークのリソース ID。cloudServicesNetwork、l3Network、l2Network、trunkedNetwork のいずれかのリソースを指定できます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentDefaultGateway

これが既定のゲートウェイであるかどうかを示すインジケーター。1 台のマシンに対して接続されているネットワーク (CloudServicesNetwork 添付ファイルを含む) の 1 つだけを True として指定できます。

型:	DefaultGateway
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentIPAllocationMethod

仮想マシンの IP 割り当てメカニズム。Dynamic と Static は、l3Network に対してのみ有効です。Disabled を指定することもできます。それ以外の場合は、Disabled のみが許可される値です。

型:	VirtualMachineIPAllocationMethod
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentIpv4Address

仮想マシンの IPv4 アドレス。このフィールドは、接続されたネットワークに IPV4 または DualStack の IPAllocationType がある場合にのみ使用されます。IPAllocationMethod が:Static の場合、このフィールドには、接続されたネットワークで指定されたサブネット内からユーザー指定の IPv4 アドレスが含まれている必要があります。動的 - このフィールドは読み取り専用ですが、接続されたネットワークで指定されたサブネット内からアドレスが設定されます。無効 - このフィールドは空になります。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentIpv6Address

仮想マシンの IPv6 アドレス。このフィールドは、接続されたネットワークに IPV6 または DualStack の IPAllocationType がある場合にのみ使用されます。IPAllocationMethod が:Static の場合、このフィールドには、接続されたネットワークで指定された範囲内からの IPv6 アドレス範囲が含まれている必要があります。動的 - このフィールドは読み取り専用ですが、接続されたネットワークで指定されたサブネット内からの範囲が設定されます。無効 - このフィールドは空になります。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudServiceNetworkAttachmentName

関連付けられているネットワークのインターフェイス名。指定した場合、ネットワーク添付ファイル名の最大長は 15 文字で、この仮想マシンに固有である必要があります。ユーザーがこの値を指定しない場合は、ネットワークリソースの既定のインターフェイス名が使用されます。CloudServicesNetwork リソースの場合、この名前は無視されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CpuCore

仮想マシン内の CPU コアの数。

型:	Int64
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

DefaultProfile パラメーターは機能しません。別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExtendedLocationName

リソースが作成される拡張された場所のリソース ID。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExtendedLocationType

拡張された場所の種類 (CustomLocation など)。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsolateEmulatorThread

フィールドは非推奨です。指定された場合、値は無視されます。この仮想マシンのエミュレータースレッドを実行するために、指定された CPU コアのいずれかが分離されているかどうかを示すインジケーター。

型:	VirtualMachineIsolateEmulatorThread
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Location

リソースが存在する地理的な場所

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MemorySizeGb

仮想マシンのメモリサイズ (GB 単位)。

型:	Int64
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

仮想マシンの名前。

型:	String
Aliases:	VirtualMachineName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NetworkAttachment

仮想マシンへのネットワーク添付ファイルの一覧。構築するには、NETWORKATTACHMENT プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	INetworkAttachment[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NetworkData

Base64 でエンコードされた cloud-init ネットワークデータ。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NoWait

コマンドを非同期的に実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OSDiskCreateOption

OS ディスクを作成するための戦略。

型:	OSDiskCreateOption
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OSDiskDeleteOption

OS ディスクを削除するための戦略。

型:	OSDiskDeleteOption
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OSDiskSizeGb

ディスクのサイズ (ギガバイト単位)。 createOption がエフェメラルの場合は必須。

型:	Int64
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PlacementHint

仮想マシンのスケジュールヒント。構築するには、PLACEMENTHINT プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IVirtualMachinePlacementHint[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

リソースグループの名前。名前の大文字と小文字は区別されます。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SshPublicKey

ssh 公開キーの一覧。各キーは、adminUsername の cloud-init ssh_authorized_keys メカニズムを使用して仮想マシンに追加されます。構築するには、SSHPUBLICKEY プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	ISshPublicKey[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageProfileVolumeAttachment

仮想マシンにアタッチするように要求されたボリュームのリソース ID。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

ターゲットサブスクリプションの ID。値は UUID である必要があります。

型:	String
配置:	Named
規定値:	(Get-AzContext).Subscription.Id
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

リソースタグ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserData

Base64 でエンコードされた cloud-init ユーザーデータ。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VirtioInterface

フィールドは非推奨です。代わりに virtualizationModel を使用してください。 virtio インターフェイスの型。

型:	VirtualMachineVirtioInterfaceType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMDeviceModel

使用するデバイスモデルの種類。

型:	VirtualMachineDeviceModelType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMImage

イメージのプルに使用される完全な URL とタグ表記を使用して、現在 OS ディスクにプロビジョニングされている仮想マシンイメージ。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMImageRepositoryCredentialsPassword

ターゲットリポジトリ内のイメージにアクセスするために使用されるパスワードまたはトークン。

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMImageRepositoryCredentialsRegistryUrl

リポジトリの資格情報の検証に使用される認証サーバーの URL。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMImageRepositoryCredentialsUsername

ターゲットリポジトリ内のイメージにアクセスするために使用されるユーザー名。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

IVirtualMachine

次の方法で共有