Add-AzVMNetworkInterface
仮想マシンにネットワーク インターフェイスを追加します。
構文
GetNicFromNicId (既定)
Add-AzVMNetworkInterface
[-VM] <PSVirtualMachine>
[-Id] <String>
[-Primary]
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetNicFromNicObject
Add-AzVMNetworkInterface
[-VM] <PSVirtualMachine>
[-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
[-DeleteOption <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzVMNetworkInterface コマンドレットは、仮想マシンにネットワーク インターフェイスを追加します。
仮想マシンを作成するときにインターフェイスを追加したり、既存の仮想マシンにインターフェイスを追加したりできます。
例
例 1: 新しい仮想マシンにネットワーク インターフェイスを追加する
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
最初のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。
このコマンドは、仮想マシンに名前とサイズを割り当てます。
2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにネットワーク インターフェイスを追加します。
例 2: 既存の仮想マシンにネットワーク インターフェイスを追加する
$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
最初のコマンドは、 Get-AzVM コマンドレットを使用して VirtualMachine07 という名前の仮想マシンを取得します。
このコマンドは、仮想マシンを $VirtualMachine 変数に格納します。
2 番目のコマンドは、$VirtualMachineに格納されている仮想マシンにネットワーク インターフェイスを追加します。
最後のコマンドは、ResourceGroup11 の$VirtualMachineに格納されている仮想マシンの状態を更新します。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeleteOption
VM 削除後のネットワーク インターフェイス削除オプションを指定します。 [デタッチ]、[削除] のオプション
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Id
仮想マシンに追加するネットワーク インターフェイスの ID を指定します。
Get-AzNetworkInterface コマンドレットを使用して、ネットワーク インターフェイスを取得できます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | NicId, NetworkInterfaceId |
パラメーター セット
GetNicFromNicId
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-NetworkInterface
ネットワーク インターフェイスを指定します。
パラメーターのプロパティ
パラメーター セット
GetNicFromNicObject
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Primary
このコマンドレットがプライマリ インターフェイスとしてネットワーク インターフェイスを追加することを示します。
パラメーターのプロパティ
パラメーター セット
GetNicFromNicId
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-VM
ネットワーク インターフェイスを追加するローカル仮想マシン オブジェクトを指定します。
仮想マシンを作成するには、 New-AzVMConfig コマンドレットを使用します。
既存の仮想マシンを取得するには、 Get-AzVM コマンドレットを使用します。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
