Freigeben über

Add-AzVMNetworkInterface

Modul:
Az.Compute Module

Fügt einer virtuellen Maschine eine Netzwerkschnittstelle hinzu.

Syntax

GetNicFromNicId (Standard) 

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

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 Objekt eines virtuellen Computers und speichert es dann in der $VirtualMachine Variablen. 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.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeleteOption

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:NicId, NetworkInterfaceId

Parametersätze

GetNicFromNicId
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-NetworkInterface

Gibt die Netzwerkschnittstelle an.

Parametereigenschaften

Typ:

List<T>[INetworkInterfaceReference]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetNicFromNicObject
Position:1
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Primary

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetNicFromNicId
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PSVirtualMachine
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:VMProfile

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSVirtualMachine

String

List<T>

SwitchParameter

Ausgaben

PSVirtualMachine