Add-AzVMNetworkInterface
將網路介面新增至虛擬機。
語法
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>]
Description
Add-AzVMNetworkInterface Cmdlet 會將網路介面新增至虛擬機。 當您建立虛擬機或將介面新增至現有的虛擬機時,您可以新增介面。
範例
範例 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變數中。 命令會將名稱和大小指派給虛擬機。 第二個命令會將網路介面新增至儲存在 $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 Cmdlet 來取得名為 VirtualMachine07 的虛擬機。 命令會將虛擬機儲存在 $VirtualMachine 變數中。 第二個命令會將網路介面新增至儲存在 $VirtualMachine 中的虛擬機。 最後一個命令會更新儲存在 ResourceGroup11 $VirtualMachine 中的虛擬機狀態。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeleteOption
指定 VM 刪除之後的網路介面刪除選項。 選項為 Detach、Delete
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Id
指定要新增至虛擬機之網路介面的標識碼。 您可以使用 Get-AzNetworkInterface Cmdlet 來取得網路介面。
類型: | String |
別名: | NicId, NetworkInterfaceId |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-NetworkInterface
指定網路介面。
類型: | List<T>[INetworkInterfaceReference] |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-Primary
指出此 Cmdlet 會將網路介面新增為主要介面。
類型: | SwitchParameter |
Position: | 2 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-VM
指定要新增網路介面的本機虛擬機物件。 若要建立虛擬機,請使用 New-AzVMConfig Cmdlet。 若要取得現有的虛擬機,請使用 Get-AzVM Cmdlet。
類型: | PSVirtualMachine |
別名: | VMProfile |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
輸入
List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]