Add-AzVMNetworkInterface

  • リファレンス
モジュール:
Az.Compute

仮想マシンにネットワーク インターフェイスを追加します。

構文

Add-AzVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-Id] <String>
   [-Primary]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
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 との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

-DeleteOption

VM 削除後のネットワーク インターフェイス削除オプションを指定します。 [デタッチ]、[削除] のオプション

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

-Id

仮想マシンに追加するネットワーク インターフェイスの ID を指定します。 Get-AzNetworkInterface コマンドレットを使用して、ネットワーク インターフェイスを取得できます。

Type:String
Aliases:NicId, NetworkInterfaceId
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NetworkInterface

ネットワーク インターフェイスを指定します。

Type:List<T>[INetworkInterfaceReference]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Primary

このコマンドレットがプライマリ インターフェイスとしてネットワーク インターフェイスを追加することを示します。

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

-VM

ネットワーク インターフェイスを追加するローカル仮想マシン オブジェクトを指定します。 仮想マシンを作成するには、New-AzVMConfig コマンドレットを使用します。 既存の仮想マシンを取得するには、Get-AzVM コマンドレットを使用します。

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

SwitchParameter

出力

PSVirtualMachine