Add-AzVMNetworkInterface

  • Referenz
Modul:
Az.Compute

Fügt einem virtuellen Computer eine Netzwerkschnittstelle hinzu

Syntax

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

Beschreibung

Das Add-AzVMNetworkInterface-Cmdlet fügt einer virtuellen Maschine eine Netzwerkschnittstelle hinzu. Sie können eine Schnittstelle hinzufügen, wenn Sie einen virtuellen Computer erstellen oder einen zu einem vorhandenen virtuellen Computer hinzufügen.

Beispiele

Beispiel 1: Hinzufügen einer Netzwerkschnittstelle zu einem neuen virtuellen Computer

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

Der erste Befehl erstellt ein VM-Objekt und speichert es in der Variablen $VirtualMachine. Der Befehl weist dem virtuellen Computer einen Namen und eine Größe zu. Der zweite Befehl fügt dem virtuellen Computer, der in $VirtualMachine gespeichert ist, eine Netzwerkschnittstelle hinzu.

Beispiel 2: Hinzufügen einer Netzwerkschnittstelle zu einem vorhandenen virtuellen Computer

$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

Der erste Befehl ruft den virtuellen Computer mit dem Namen VirtualMachine07 mithilfe des Cmdlets "Get-AzVM " ab. Der Befehl speichert den virtuellen Computer in der Variablen $VirtualMachine . Der zweite Befehl fügt dem virtuellen Computer, der in $VirtualMachine gespeichert ist, eine Netzwerkschnittstelle hinzu. Der letzte Befehl aktualisiert den Zustand des virtuellen Computers, der in $VirtualMachine in ResourceGroup11 gespeichert ist.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeleteOption

Gibt die Option zum Löschen der Netzwerkschnittstelle nach dem Löschen des virtuellen Computers an. Optionen sind "Trennen", "Löschen"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Id

Gibt die ID einer Netzwerkschnittstelle an, die einem virtuellen Computer hinzugefügt werden soll. Sie können das Cmdlet Get-AzNetworkInterface verwenden, um eine Netzwerkschnittstelle abzurufen.

Typ:String
Aliase:NicId, NetworkInterfaceId
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NetworkInterface

Gibt die Netzwerkschnittstelle an.

Typ:List<T>[INetworkInterfaceReference]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Primary

Gibt an, dass dieses Cmdlet die Netzwerkschnittstelle als primäre Schnittstelle hinzufügt.

Typ:SwitchParameter
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein lokales virtuelles Computerobjekt an, dem eine Netzwerkschnittstelle hinzugefügt werden soll. Verwenden Sie das Cmdlet New-AzVMConfig , um einen virtuellen Computer zu erstellen. Verwenden Sie das Cmdlet "Get-AzVM ", um einen vorhandenen virtuellen Computer abzurufen.

Typ:PSVirtualMachine
Aliase:VMProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

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

Ausgaben

PSVirtualMachine