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>]
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 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeleteOption
指定 VM 刪除後的網路介面刪除選項。 選項包括分離、刪除
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Id
指定要新增至虛擬機器的網路介面識別碼。
您可以使用 Get-AzNetworkInterface Cmdlet 來取得網路介面。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | NicId, 網路介面 ID |
參數集
GetNicFromNicId
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-NetworkInterface
指定網路介面。
參數屬性
參數集
GetNicFromNicObject
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Primary
表示此 Cmdlet 會將網路介面新增為主要介面。
參數屬性
參數集
GetNicFromNicId
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-VM
指定要新增網路介面的本機虛擬機器物件。
若要建立虛擬機器，請使用 New-AzVMConfig Cmdlet。
若要取得現有的虛擬機器，請使用 Get-AzVM Cmdlet。
參數屬性
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
