Поделиться через


Add-AzureRmVMNetworkInterface

Добавляет сетевой интерфейс для виртуальной машины.

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из 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. Команда присваивает имя и размер виртуальной машине. Вторая команда добавляет сетевой интерфейс к виртуальной машине, хранящейся в $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

Первая команда получает виртуальную машину с именем VirtualMachine07 с помощью командлета Get-AzureRmVM . Она сохраняет имя виртуальной машины в переменной $VirtualMachine . Вторая команда добавляет сетевой интерфейс к виртуальной машине, хранящейся в $VirtualMachine. Последняя команда обновляет состояние виртуальной машины, хранящейся в $VirtualMachine в ResourceGroup11.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Указывает идентификатор сетевого интерфейса для добавления в виртуальную машину. Для получения сетевого интерфейса можно использовать командлет Get-AzureRmNetworkInterface .

Тип:String
Aliases:NicId, NetworkInterfaceId
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NetworkInterface

Указывает сетевой интерфейс.

Тип:List<T>[INetworkInterfaceReference]
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Primary

Указывает, что этот командлет добавляет сетевой интерфейс в качестве основного интерфейса.

Тип:SwitchParameter
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VM

Указывает объект локальной виртуальной машины, в который необходимо добавить сетевой интерфейс. Чтобы создать виртуальную машину, используйте командлет New-AzureRmVMConfig . Чтобы получить существующую виртуальную машину, используйте командлет Get-AzureRmVM .

Тип:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

Выходные данные

PSVirtualMachine