New-AzureRmVMConfig
構成可能な仮想マシン オブジェクトを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmVMConfig
[-VMName] <String>
[-VMSize] <String>
[[-AvailabilitySetId] <String>]
[[-LicenseType] <String>]
[-Zone <String[]>]
[-Tags <Hashtable>]
[-EnableUltraSSD]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmVMConfig
[-VMName] <String>
[-VMSize] <String>
[[-AvailabilitySetId] <String>]
[[-LicenseType] <String>]
[-IdentityType] <ResourceIdentityType>
[-IdentityId <String[]>]
[-Zone <String[]>]
[-Tags <Hashtable>]
[-EnableUltraSSD]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmVMConfig
[-VMName] <String>
[-VMSize] <String>
[[-AvailabilitySetId] <String>]
[[-LicenseType] <String>]
[-AssignIdentity]
[-Zone <String[]>]
[-Tags <Hashtable>]
[-EnableUltraSSD]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
New-AzureRmVMConfig コマンドレットは、Azure 用に構成可能なローカル仮想マシン オブジェクトを作成します。 その他のコマンドレットを使用して、Set-AzureRmVMOperatingSystem、Set-AzureRmVMSourceImage、Add-AzureRmVMNetworkInterface、Set-AzureRmVMOSDisk などの仮想マシン オブジェクトを構成できます。
例
例 1: 仮想マシン オブジェクトを作成する
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitablitySet03 という名前の可用性セットを取得し、そのオブジェクトを $AvailabilitySet 変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属しています。
パラメーター
-AssignIdentity
仮想マシンのシステム割り当て ID を指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailabilitySetId
可用性セットの ID を指定します。 可用性セット オブジェクトを取得するには、Get-AzureRmAvailabilitySet コマンドレットを使用します。 可用性セット オブジェクトには、ID プロパティが含まれています。
型: | String |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableUltraSSD
VM にストレージ アカウントの種類UltraSSD_LRS 1 つ以上のマネージド データ ディスクを持つ機能を有効にします。 ストレージ アカウントの種類がUltraSSD_LRSマネージド ディスクは、このプロパティが有効になっている場合にのみ、仮想マシンに追加できます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-IdentityId
仮想マシン スケール セットに関連付けられているユーザー ID の一覧を指定します。 ユーザー ID 参照は、"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identits/{identityName}" という形式の ARM リソース ID になります。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-IdentityType
構成されている場合は、仮想マシンの ID。
型: | Nullable<T>[ResourceIdentityType] |
指定可能な値: | SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None |
配置: | 4 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LicenseType
ライセンスの種類。これは、独自のライセンス シナリオを持ち込むためです。
型: | String |
配置: | 3 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Tags
リソースにアタッチされているタグ。
型: | Hashtable |
Aliases: | Tag |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMName
仮想マシンの名前を指定します。
型: | String |
Aliases: | ResourceName, Name |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VMSize
仮想マシンのサイズを指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Zone
仮想マシンのゾーン一覧を指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
String[]