Udostępnij za pomocą

Add-AzVMNetworkInterface

Moduł:
Az.Compute Module

Dodaje interfejs sieciowy do maszyny wirtualnej.

Składnia

GetNicFromNicId (domyślnie) 

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>]

Opis

Polecenie cmdlet Add-AzVMNetworkInterface dodaje interfejs sieciowy do maszyny wirtualnej. Interfejs można dodać podczas tworzenia maszyny wirtualnej lub dodać go do istniejącej maszyny wirtualnej.

Przykłady

Przykład 1. Dodawanie interfejsu sieciowego do nowej maszyny wirtualnej

$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"

Pierwsze polecenie tworzy obiekt maszyny wirtualnej, a następnie przechowuje go w zmiennej $VirtualMachine. Polecenie przypisuje nazwę i rozmiar do maszyny wirtualnej. Drugie polecenie dodaje interfejs sieciowy do maszyny wirtualnej przechowywanej w $VirtualMachine.

Przykład 2. Dodawanie interfejsu sieciowego do istniejącej maszyny wirtualnej

$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

Pierwsze polecenie pobiera maszynę wirtualną o nazwie VirtualMachine07 przy użyciu polecenia cmdlet Get-AzVM . Polecenie przechowuje maszynę wirtualną w zmiennej $VirtualMachine. Drugie polecenie dodaje interfejs sieciowy do maszyny wirtualnej przechowywanej w $VirtualMachine. Ostatnie polecenie aktualizuje stan maszyny wirtualnej przechowywanej w $VirtualMachine w grupie ResourceGroup11.

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DeleteOption

Określa opcję usuwania interfejsu sieciowego po usunięciu maszyny wirtualnej. Opcje to Odłączanie, Usuwanie

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Id

Określa identyfikator interfejsu sieciowego, który ma zostać dodany do maszyny wirtualnej. Aby uzyskać interfejs sieciowy, możesz użyć polecenia cmdlet Get-AzNetworkInterface .

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator karty sieciowej, NetworkInterfaceId

Zestawy parametrów

GetNicFromNicId
Position:1
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-NetworkInterface

Określa interfejs sieciowy.

Właściwości parametru

Typ:

List<T>[INetworkInterfaceReference]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

GetNicFromNicObject
Position:1
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Primary

Wskazuje, że to polecenie cmdlet dodaje interfejs sieciowy jako interfejs podstawowy.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

GetNicFromNicId
Position:2
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-VM

Określa lokalny obiekt maszyny wirtualnej, do którego ma zostać dodany interfejs sieciowy. Aby utworzyć maszynę wirtualną, użyj polecenia cmdlet New-AzVMConfig . Aby uzyskać istniejącą maszynę wirtualną, użyj polecenia cmdlet Get-AzVM .

Właściwości parametru

Typ:PSVirtualMachine
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:VMProfile

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

PSVirtualMachine

String

List<T>

SwitchParameter

Dane wyjściowe

PSVirtualMachine