New-AzVMConfig

モジュール:

Az.Compute

構成可能な仮想マシン オブジェクトを作成します。

構文

New-AzVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-Zone <String[]>]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-MaxPrice <Double>]
   [-EvictionPolicy <String>]
   [-Priority <String>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-EncryptionAtHost]
   [-CapacityReservationGroupId <String>]
   [-ImageReferenceId <String>]
   [-UserData <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-IdentityType] <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-Zone <String[]>]
   [-ProximityPlacementGroupId <String>]
   [-HostId <String>]
   [-VmssId <String>]
   [-MaxPrice <Double>]
   [-EvictionPolicy <String>]
   [-Priority <String>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-EncryptionAtHost]
   [-CapacityReservationGroupId <String>]
   [-ImageReferenceId <String>]
   [-UserData <String>]
   [-PlatformFaultDomain <Int32>]
   [-HibernationEnabled]
   [-vCPUCountAvailable <Int32>]
   [-vCPUCountPerCore <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzVMConfig コマンドレットは、Azure 用に構成可能なローカル仮想マシン オブジェクトを作成します。 その他のコマンドレットを使用して、Set-AzVMOperatingSystem、Set-AzVMSourceImage、Add-AzVMNetworkInterface、Set-AzVMOSDisk などの仮想マシン オブジェクトを構成できます。

例

例 1: 仮想マシン オブジェクトを作成する

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id

最初のコマンドは、ResourceGroup11 という名前のリソース グループに AvailabilitySet03 という名前の可用性セットを取得し、そのオブジェクトを$AvailabilitySet変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属します。

パラメーター

-AvailabilitySetId

可用性セットの ID を指定します。 可用性セット オブジェクトを取得するには、Get-AzAvailabilitySet コマンドレットを使用します。 可用性セット オブジェクトには ID プロパティが含まれています。
同じ可用性セットで指定された仮想マシンは、可用性を最大化するために別々のノードに割り当てられます。
可用性セットの詳細については、「 仮想マシンの可用性の管理」を参照してください。
Azure の計画メンテナンスの詳細については、「Azure の仮想マシンの計画メンテナンス」を参照してください。
現時点では、VM は作成時にのみ可用性セットに追加できます。 VM が追加される可用性セットは、可用性セット リソースと同じリソース グループの下に存在する必要があります。 既存の VM を可用性セットに追加することはできません。
このプロパティは、null 以外の properties.virtualMachineScaleSet 参照と共に存在できません。

Type:	String
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-CapacityReservationGroupId

割り当てに使用される容量予約グループの ID。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableUltraSSD

VM にストレージ アカウントの種類がUltraSSD_LRSのマネージド データ ディスクを 1 つ以上持つ機能を有効にします。 ストレージ アカウントの種類がUltraSSD_LRSマネージド ディスクは、このプロパティが有効になっている場合にのみ仮想マシンに追加できます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-EncryptionAtHost

EncryptionAtHost プロパティは、要求のユーザーが仮想マシンまたは仮想マシン スケール セットの Host Encryption を有効または無効にするために使用できます。 これにより、ホスト自体のリソース/一時ディスクを含むすべてのディスクの暗号化が有効になります。 既定値: このプロパティがリソースに対して true に設定されていない限り、ホストでの暗号化は無効になります。

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EvictionPolicy

Azure Spot 仮想マシンの削除ポリシー。 サポートされている値は、"割り当て解除" と "削除" です。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-HibernationEnabled

VM の休止機能を有効または無効にするフラグ。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-HostId

ホストの ID

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityId

仮想マシン スケール セットに関連付けられているユーザー ID の一覧を指定します。 ユーザー ID 参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identits/{identityName} という形式の ARM リソース ID になります。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityType

構成されている場合は、仮想マシンの ID。

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	4
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceId

VM デプロイの共有ギャラリー イメージの一意の ID を指定しました。 これは、共有ギャラリー イメージの GET 呼び出しからフェッチできます。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseType

ライセンスの種類を指定します。これは、仮想マシンのイメージまたはディスクがオンプレミスでライセンスされたことを示します。 Windows Server で使用できる値は次のとおりです。

• Windows_Client
• Windows_Server

Linux Server オペレーティング システムで使用できる値は次のとおりです。

• RHEL_BYOS (RHEL の場合)
• SLES_BYOS (SUSE の場合)

Type:	String
Position:	3
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPrice

優先順位の低い VM/VMSS に対して支払う最大価格を指定します。 この価格は米ドルです。 この価格は、VM サイズの現在の低優先度価格と比較されます。 また、価格は低優先度 VM/VMSS の作成/更新時に比較され、maxPrice が現在の低優先度価格より大きい場合にのみ操作が成功します。 現在の低優先度の価格が VM/VMSS の作成後に maxPrice を超えた場合、maxPrice は低優先度 VM/VMSS の削除にも使用されます。 使用できる値は、0 より大きい任意の 10 進値です。 例: 0.01538。 -1 は、価格上の理由から優先順位の低い VM/VMSS を削除しないことを示します。 また、ユーザーが提供していない場合、既定の最大価格は -1 です。

Type:	Double
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PlatformFaultDomain

仮想マシンの障害ドメインを指定します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Priority

仮想マシンの優先度。 サポートされている値は、'Regular'、'Spot'、および 'Low' のみです。 "Regular" は通常の仮想マシン用です。 "スポット" はスポット仮想マシン用です。 'Low' はスポット仮想マシン用でもありますが、'Spot' に置き換えられます。 'Low' の代わりに 'Spot' を使用してください。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ProximityPlacementGroupId

この仮想マシンで使用する近接通信配置グループのリソース ID。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Tags

リソースにアタッチされているタグ。

Type:	Hashtable
Aliases:	Tag
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UserData

VM の UserData。これは base-64 でエンコードされます。 顧客はここにシークレットを渡すべきではありません。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-vCPUCountAvailable

VM で使用できる vCPU の数を指定します。 このプロパティが要求本文で指定されていない場合、既定の動作では、 リージョン内で使用可能なすべての仮想マシン サイズを一覧表示する API 応答で公開される VM サイズに対して使用可能な vCPU の値に設定します。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-vCPUCountPerCore

vCPU と物理コアの比率を指定します。 このプロパティが要求本文で指定されていない場合、既定の動作は、 リージョン内のすべての使用可能な仮想マシン サイズを一覧表示する API 応答で公開される VM サイズの vCPUPerCore の値に設定されます。 このプロパティを 1 に設定すると、ハイパースレッディングが無効になります。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

仮想マシンの名前を指定します。

Type:	String
Aliases:	ResourceName, Name
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMSize

仮想マシンのサイズを指定します。

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VmssId

仮想マシン スケール セットの ID

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Zone

仮想マシンの可用性ゾーンの一覧を指定します。 使用できる値は、リージョンの機能によって異なります。 通常、使用できる値は 1,2,3 です。

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

入力

String

String[]

Hashtable

SwitchParameter

出力

PSVirtualMachine

関連リンク

• Update-AzVM
• Set-AzVMOperatingSystem
• Set-AzVMSourceImage
• Get-AzAvailabilitySet