New-AzNetworkCloudVirtualMachine
新しい仮想マシンを作成するか、既存の仮想マシンのプロパティを作成します。
構文
CreateExpanded (既定)
New-AzNetworkCloudVirtualMachine
-Name <String>
-ResourceGroupName <String>
-AdminUsername <String>
-CloudServiceNetworkAttachmentAttachedNetworkId <String>
-CloudServiceNetworkAttachmentIPAllocationMethod <String>
-CpuCore <Int64>
-ExtendedLocationName <String>
-ExtendedLocationType <String>
-Location <String>
-MemorySizeGb <Int64>
-OSDiskSizeGb <Int64>
-VMImage <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-BootMethod <String>]
[-CloudServiceNetworkAttachmentDefaultGateway <String>]
[-CloudServiceNetworkAttachmentIpv4Address <String>]
[-CloudServiceNetworkAttachmentIpv6Address <String>]
[-CloudServiceNetworkAttachmentName <String>]
[-ConsoleExtendedLocationName <String>]
[-ConsoleExtendedLocationType <String>]
[-EnableSystemAssignedIdentity]
[-IsolateEmulatorThread <String>]
[-NetworkAttachment <INetworkAttachment[]>]
[-NetworkData <String>]
[-NetworkDataContent <String>]
[-OSDiskCreateOption <String>]
[-OSDiskDeleteOption <String>]
[-PlacementHint <IVirtualMachinePlacementHint[]>]
[-SshPublicKey <ISshPublicKey[]>]
[-StorageProfileVolumeAttachment <String[]>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-UserData <String>]
[-UserDataContent <String>]
[-VMDeviceModel <String>]
[-VMImageRepositoryCredentialsPassword <SecureString>]
[-VMImageRepositoryCredentialsRegistryUrl <String>]
[-VMImageRepositoryCredentialsUsername <String>]
[-VirtioInterface <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzNetworkCloudVirtualMachine
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzNetworkCloudVirtualMachine
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-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
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-AsJob
コマンドをジョブとして実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-BootMethod
仮想マシンのブート方法を選択します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentAttachedNetworkId
仮想マシンに接続されている関連付けられているネットワークのリソース ID。
cloudServicesNetwork、l3Network、l2Network、trunkedNetwork のいずれかのリソースを指定できます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentDefaultGateway
これが既定のゲートウェイであるかどうかを示すインジケーター。
1 台のマシンに対して接続されているネットワーク (CloudServicesNetwork 添付ファイルを含む) の 1 つだけを True として指定できます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentIPAllocationMethod
仮想マシンの IP 割り当てメカニズム。
動的および静的は、l3Network に対してのみ有効です。また、Disabled を指定することもできます。
それ以外の場合、許可される値は Disabled のみです。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentIpv4Address
仮想マシンの IPv4 アドレス。
このフィールドは、接続されているネットワークに IPV4 または DualStack の IPAllocationType がある場合にのみ使用されます。
IPAllocationMethod が Static の場合 - このフィールドには、接続されたネットワークで指定されたサブネット内のユーザー指定の IPv4 アドレスが含まれている必要があります。
動的 - このフィールドは読み取り専用ですが、接続されたネットワークで指定されたサブネット内からアドレスが設定されます。
無効 - このフィールドは空になります。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentIpv6Address
仮想マシンの IPv6 アドレス。
このフィールドは、接続されているネットワークに IPV6 または DualStack の IPAllocationType がある場合にのみ使用されます。
IPAllocationMethod が Static の場合 - このフィールドには、接続されたネットワークで指定された範囲内の IPv6 アドレス範囲が含まれている必要があります。
動的 - このフィールドは読み取り専用ですが、接続されたネットワークで指定されたサブネット内からの範囲が設定されます。
無効 - このフィールドは空になります。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CloudServiceNetworkAttachmentName
関連付けられているネットワークのインターフェイス名。
指定した場合、ネットワーク添付ファイル名の最大長は 15 文字で、この仮想マシンに固有である必要があります。
ユーザーがこの値を指定しない場合は、ネットワーク リソースの既定のインターフェイス名が使用されます。
CloudServicesNetwork リソースの場合、この名前は無視されます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ConsoleExtendedLocationName
リソースが作成される拡張された場所のリソース ID。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ConsoleExtendedLocationType
拡張された場所の種類 (CustomLocation など)。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-CpuCore
仮想マシン内の CPU コアの数。
パラメーターのプロパティ
型: Int64
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-DefaultProfile
DefaultProfile パラメーターは機能しません。
別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。
パラメーターのプロパティ
型: PSObject
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-EnableSystemAssignedIdentity
リソースに対してシステム割り当て ID を有効にするかどうかを決定します。
パラメーターのプロパティ
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ExtendedLocationName
リソースが作成される拡張された場所のリソース ID。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ExtendedLocationType
拡張された場所の種類 (CustomLocation など)。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-IfMatch
変換の ETag。
現在のリソースを常に上書きするには、この値を省略します。
同時変更が誤って上書きされないように、最後に表示された ETag 値を指定します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-IfNoneMatch
新しいレコード セットの作成を許可するが、既存のリソースを更新できないようにするには、'*' に設定します。
その他の値はサポートされていないため、サーバーからエラーが発生します。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-IsolateEmulatorThread
フィールドは非推奨です。指定された場合、値は無視されます。
この仮想マシンのエミュレーター スレッドを実行するために、指定された CPU コアのいずれかが分離されているかどうかを示すインジケーター。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-JsonFilePath
作成操作に指定された Json ファイルのパス
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateViaJsonFilePath
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-JsonString
作成操作に指定された Json 文字列
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateViaJsonString
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Location
リソースが存在する地理的な場所
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-MemorySizeGb
仮想マシンのメモリ サイズ。
割り当てはギビバイト単位で測定されます。
パラメーターのプロパティ
型: Int64
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Name
仮想マシンの名前。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
Aliases: 仮想マシン名
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NetworkAttachment
仮想マシンへのネットワーク添付ファイルの一覧。
パラメーターのプロパティ
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NetworkData
非推奨のフィールド: Base64 でエンコードされた cloud-init ネットワーク データ。
networkDataContent プロパティは、このプロパティよりも優先的に使用されます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NetworkDataContent
Base64 でエンコードされた cloud-init ネットワーク データ。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-NoWait
コマンドを非同期的に実行する
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-OSDiskCreateOption
OS ディスクを作成するための戦略。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-OSDiskDeleteOption
OS ディスクを削除するための戦略。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-OSDiskSizeGb
ディスクのサイズ。
createOption がエフェメラルの場合は必須。
割り当てはギビバイト単位で測定されます。
パラメーターのプロパティ
型: Int64
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-PlacementHint
仮想マシンのスケジュール ヒント。
パラメーターのプロパティ
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-ResourceGroupName
リソース グループの名前。
名前は大文字と小文字を区別しません。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SshPublicKey
ssh 公開キーの一覧。
各キーは、adminUsername の cloud-init ssh_authorized_keys メカニズムを使用して仮想マシンに追加されます。
パラメーターのプロパティ
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-StorageProfileVolumeAttachment
仮想マシンにアタッチするように要求されたボリュームのリソース ID。
パラメーターのプロパティ
型: String [ ]
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-SubscriptionId
ターゲット サブスクリプションの ID。
値は UUID である必要があります。
パラメーターのプロパティ
型: String
規定値: (Get-AzContext).Subscription.Id
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-Tag
リソース タグ。
パラメーターのプロパティ
型: Hashtable
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-UserAssignedIdentity
リソースに関連付けられているユーザー割り当て ID の配列。
配列内の要素は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft の形式の ARM リソース ID になります。ManagedIdentity/userAssignedIdentities/{identityName}.'
パラメーターのプロパティ
型: String [ ]
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-UserData
非推奨のフィールド: Base64 でエンコードされた cloud-init ユーザー データ。
userDataContent プロパティは、このプロパティよりも優先的に使用されます。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-UserDataContent
Base64 でエンコードされた cloud-init ユーザー データ。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VirtioInterface
フィールドは非推奨です。代わりに virtualizationModel を使用してください。
virtio インターフェイスの型。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMDeviceModel
使用するデバイス モデルの種類。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMImage
イメージのプルに使用される完全な URL とタグ表記を使用して、現在 OS ディスクにプロビジョニングされている仮想マシン イメージ。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: True
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMImageRepositoryCredentialsPassword
ターゲット リポジトリ内のイメージにアクセスするために使用されるパスワードまたはトークン。
パラメーターのプロパティ
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMImageRepositoryCredentialsRegistryUrl
リポジトリの資格情報の検証に使用される認証サーバーの URL。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-VMImageRepositoryCredentialsUsername
ターゲット リポジトリ内のイメージにアクセスするために使用されるユーザー名。
パラメーターのプロパティ
型: String
規定値: None
ワイルドカードのサポート: False
DontShow: False
パラメーター セット
CreateExpanded
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named
必須: False
パイプラインからの値: False
プロパティ名別のパイプラインからの値: False
残りの引数からの値: False
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParameters を参照してください。
出力