New-AzStackHCIVMVirtualMachine

仮想マシンを作成または更新する操作。 一部のプロパティは、仮想マシンの作成時にのみ設定できます。

構文

ByImageId (既定)

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -ImageId <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <SecureString>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByImageName

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -ImageName <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <SecureString>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-ImageResourceGroup <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByOsDiskId

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -OSDiskId <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <SecureString>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByOsDiskName

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -OSDiskName <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <SecureString>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-OSDiskResourceGroup <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

仮想マシンを作成または更新する操作。 一部のプロパティは、仮想マシンの作成時にのみ設定できます。

例 1: イメージを使用して仮想マシンを作成する。

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux"  -ImageName "testImage" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm"  -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus"
Name            ResourceGroupName
----            -----------------
testVm          test-rg

このコマンドは、ギャラリー イメージから仮想マシンを作成します。

例 2: ディスクを使用して仮想マシンを作成する。

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux" -OsDiskName "testOsDisk10" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -Location "eastus"
Name            ResourceGroupName
----            -----------------
testVm          test-rg

このコマンドは、ディスクから仮想マシンを作成します。

パラメーター

-AdminPassword

AdminPassword - 管理者パスワード (SecureString として)

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

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

パラメーター セット

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

-AdminUsername

AdminUsername - 管理者のユーザー名

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

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

パラメーター セット

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

-AsJob

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

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

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

パラメーター セット

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

-ComputerName

ComputerName - コンピュータの名前

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

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

パラメーター セット

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

-Confirm

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

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

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

パラメーター セット

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

-CustomLocationId

拡張された場所の名前。

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

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

パラメーター セット

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

-DataDiskId

データ ディスク - ID 形式で仮想マシンに接続するデータ ディスクの一覧。

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

型:

String[]

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

パラメーター セット

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

-DataDiskName

データ ディスク - 名前形式で仮想マシンに接続するデータ ディスクの一覧。

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

型:

String[]

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

パラメーター セット

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

-DataDiskResourceGroup

データ ディスク - データ ディスクのリソース グループ。

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

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

パラメーター セット

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

-DefaultProfile

Azureとの通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

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

-DisablePasswordAuthentication

DisablePasswordAuthentication - パスワード認証を無効にする必要があるかどうか

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

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

パラメーター セット

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

-DynamicMemoryMaximumMemoryInMb

最大動的メモリ

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

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

パラメーター セット

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

-DynamicMemoryMinimumMemoryInMb

最小動的メモリ

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

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

パラメーター セット

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

-DynamicMemoryTargetBuffer

仮想マシンが必要と考えられる合計メモリに対する割合として、実行時に仮想マシン用に予約する必要がある追加メモリの量を定義します。 これは、動的メモリが有効になっている仮想システムにのみ適用されます。 このプロパティの範囲は 5 ~ 2000 です。

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

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

パラメーター セット

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

-EnableAutomaticUpdate

コンピューターで EnableAutomaticUpdates を有効にするかどうかを指定します。

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

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

パラメーター セット

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

-EnableTpm

TPM を有効にするかどうかを示すために使用されます

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

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

パラメーター セット

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

-IdentityType

ID の種類。

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

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

パラメーター セット

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

-ImageId

VM を作成するイメージのリソース ID。

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

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

パラメーター セット

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

-ImageName

VM を作成するイメージの名前。

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

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

パラメーター セット

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

-ImageResourceGroup

VM を作成するイメージのリソース グループ。

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

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

パラメーター セット

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

-Location

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

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

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

パラメーター セット

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

-Name

仮想マシンの名前

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

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:仮想マシン名

パラメーター セット

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

-NicId

NetworkInterfaces - 仮想マシンにアタッチするネットワーク インターフェイスの一覧 (ARM ID 形式)。

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

型:

String[]

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

パラメーター セット

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

-NicName

NetworkInterfaces - 名前形式で仮想マシンに接続するネットワーク インターフェイスの一覧。

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

型:

String[]

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

パラメーター セット

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

-NicResourceGroup

NetworkInterfaces - ネットワーク インターフェイスのリソース グループ。

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

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

パラメーター セット

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

-NoWait

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

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

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

パラメーター セット

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

-OSDiskId

OS ディスクのリソース ID

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

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

パラメーター セット

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

-OSDiskName

OS ディスクの名前

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

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

パラメーター セット

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

-OSDiskResourceGroup

OS ディスクのリソース グループ

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

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

パラメーター セット

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

-OsType

OsType - OS が Linux か Windows かを指定する文字列

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

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

パラメーター セット

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

-ProvisionVMAgent

仮想マシンの作成プロセス中に Arc for Servers エージェントのオンボードをトリガーするかどうかを示すために使用されます。 VM エージェントは既定でプロビジョニングされます。 無効にするには、-ProvisionVMAgent:$false を渡してください。

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

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

パラメーター セット

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

-ProvisionVMConfigAgent

仮想マシン構成エージェントを仮想マシンにプロビジョニングする必要があるかどうかを示します。 このプロパティが指定されていない場合、既定の動作では true に設定されます。 VM 構成エージェントは既定でプロビジョニングされます。 -ProvisionVMConfigAgent:$false を渡して無効にしてください。

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

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

パラメーター セット

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

-ResourceGroupName

リソース グループの名前。 名前は大文字と小文字を区別しません。

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

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

パラメーター セット

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

-SecureBootEnabled

仮想マシンでセキュア ブートを有効にするかどうかを指定します。

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

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

パラメーター セット

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

-SshPublicKey

PublicKeys - VM での認証に使用される SSH 公開キーの一覧

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

型:

String[]

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

パラメーター セット

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

-StoragePathId

VM 構成ファイルをホストするストレージ コンテナーの ID

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

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

パラメーター セット

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

-StoragePathName

VM 構成ファイルをホストするストレージ コンテナーの名前

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

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

パラメーター セット

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

-StoragePathResourceGroup

ストレージ コンテナー リソース グループ。 この値が指定されていない場合は、仮想マシンのリソース グループが使用されます。

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

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

パラメーター セット

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

-SubscriptionId

ターゲット サブスクリプションの ID。

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

型:String
規定値:(Get-AzContext).Subscription.Id
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

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

-TimeZone

仮想マシンのタイムゾーン

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

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

パラメーター セット

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

-VmMemoryInMB

仮想マシンの RAM (MB 単位)

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

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

パラメーター セット

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

-VmProcessor

仮想マシンのプロセッサの数

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

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

パラメーター セット

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

-VmSize

VM のサイズ。 定義済みのサイズまたはカスタムを指定できます。 可能な定義済みのサイズには、カスタム、Standard_A2_v2、Standard_A4_v2、Standard_D16s_v3、Standard_D2s_v3、Standard_D32s_v3、Standard_D4s_v3、Standard_D8s_v3、Standard_DS13_v2 Standard_DS2_v2、Standard_DS3_v2、Standard_DS4_v2、Standard_DS5_v2、Standard_K8S2_v1、Standard_K8S3_v1、Standard_K8S4_v1、Standard_K8S5_v1、Standard_K8S_v1、Standard_NK12,Standard_NK6,Standard_NV12, StandardNv6

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

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

パラメーター セット

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

-WhatIf

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

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

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

パラメーター セット

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

CommonParameters

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

出力

IVirtualMachineInstance