Add-AzureRmVMNetworkInterface
仮想マシンにネットワーク インターフェイスを追加します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRmVMNetworkInterface
[-VM] <PSVirtualMachine>
[-Id] <String>
[-Primary]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmVMNetworkInterface
[-VM] <PSVirtualMachine>
[-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzureRmVMNetworkInterface コマンドレットは、仮想マシンにネットワーク インターフェイスを追加します。 仮想マシンを作成するときにインターフェイスを追加したり、既存の仮想マシンにインターフェイスを追加したりできます。
例
例 1: 新しい仮想マシンにネットワーク インターフェイスを追加する
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
最初のコマンドは、仮想マシン オブジェクトを作成し、それを $VirtualMachine 変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにネットワーク インターフェイスを追加します。
例 2: 既存の仮想マシンにネットワーク インターフェイスを追加する
PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
最初のコマンドは、Get-AzureRmVM コマンドレットを使用して VirtualMachine07 という名前の仮想マシンを取得します。 コマンドは仮想マシンを変数 $VirtualMachine に保存します。 2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにネットワーク インターフェイスを追加します。 最後のコマンドは、ResourceGroup11 の$VirtualMachineに格納されている仮想マシンの状態を更新します。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
仮想マシンに追加するネットワーク インターフェイスの ID を指定します。 Get-AzureRmNetworkInterface コマンドレットを使用して、ネットワーク インターフェイスを取得できます。
型: | String |
Aliases: | NicId, NetworkInterfaceId |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-NetworkInterface
ネットワーク インターフェイスを指定します。
型: | List<T>[INetworkInterfaceReference] |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Primary
このコマンドレットがプライマリ インターフェイスとしてネットワーク インターフェイスを追加することを示します。
型: | SwitchParameter |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VM
ネットワーク インターフェイスを追加するローカル仮想マシン オブジェクトを指定します。 仮想マシンを作成するには、New-AzureRmVMConfig コマンドレットを使用します。 既存の仮想マシンを取得するには、Get-AzureRmVM コマンドレットを使用します。
型: | PSVirtualMachine |
Aliases: | VMProfile |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]