Add-AzVMNetworkInterface

Hiermee voegt u een netwerkinterface aan een virtuele machine toe.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

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

Description

De cmdlet Add-AzVMNetworkInterface voegt een netwerkinterface toe aan een virtuele machine. U kunt een interface toevoegen wanneer u een virtuele machine maakt of er een toevoegt aan een bestaande virtuele machine.

Voorbeelden

Voorbeeld 1: Een netwerkinterface toevoegen aan een nieuwe virtuele machine

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

Met de eerste opdracht wordt een virtuele-machineobject gemaakt en vervolgens opgeslagen in de variabele $VirtualMachine. Met de opdracht wordt een naam en grootte toegewezen aan de virtuele machine. Met de tweede opdracht wordt een netwerkinterface toegevoegd aan de virtuele machine die is opgeslagen in $VirtualMachine.

Voorbeeld 2: Een netwerkinterface toevoegen aan een bestaande virtuele machine

$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

De eerste opdracht haalt de virtuele machine met de naam VirtualMachine07 op met behulp van de Get-AzVM-cmdlet . Met de opdracht wordt de virtuele machine opgeslagen in de variabele $VirtualMachine. Met de tweede opdracht wordt een netwerkinterface toegevoegd aan de virtuele machine die is opgeslagen in $VirtualMachine. Met de laatste opdracht wordt de status bijgewerkt van de virtuele machine die is opgeslagen in $VirtualMachine in ResourceGroup11.

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeleteOption

Hiermee geeft u de optie Voor het verwijderen van de netwerkinterface op nadat de VM is verwijderd. Opties zijn loskoppelen, verwijderen

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Id

Hiermee geeft u de id van een netwerkinterface die moet worden toegevoegd aan een virtuele machine. U kunt de cmdlet Get-AzNetworkInterface gebruiken om een netwerkinterface te verkrijgen.

Type:String
Aliases:NicId, NetworkInterfaceId
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-NetworkInterface

Hiermee geeft u de netwerkinterface.

Type:List<T>[INetworkInterfaceReference]
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Primary

Geeft aan dat met deze cmdlet de netwerkinterface wordt toegevoegd als de primaire interface.

Type:SwitchParameter
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-VM

Hiermee geeft u een lokale virtuele machine-object waaraan een netwerkinterface moet worden toegevoegd. Als u een virtuele machine wilt maken, gebruikt u de cmdlet New-AzVMConfig . Gebruik de cmdlet Get-AzVM om een bestaande virtuele machine te verkrijgen.

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

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

Uitvoerwaarden

PSVirtualMachine