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>]
    [-IsolateEmulatorThread <String>]
    [-NetworkAttachment <INetworkAttachment[]>]
    [-NetworkData <String>]
    [-OSDiskCreateOption <String>]
    [-OSDiskDeleteOption <String>]
    [-PlacementHint <IVirtualMachinePlacementHint[]>]
    [-SshPublicKey <ISshPublicKey[]>]
    [-StorageProfileVolumeAttachment <String[]>]
    [-Tag <Hashtable>]
    [-UserData <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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(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 割り当てメカニズム。Dynamic と Static は、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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(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

-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

仮想マシンへのネットワーク添付ファイルの一覧。

パラメーターのプロパティ

型:

INetworkAttachment[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NetworkData

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

CreateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NoWait

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(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

仮想マシンのスケジュール ヒント。

パラメーターのプロパティ

型:

IVirtualMachinePlacementHint[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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 メカニズムを使用して仮想マシンに追加されます。

パラメーターのプロパティ

型:

ISshPublicKey[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-UserData

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

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

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

IVirtualMachine