Share via

Add-AzureRmVMNetworkInterface

  • Referentie
Module:
AzureRM.Compute

Hiermee voegt u een netwerkinterface aan een virtuele machine toe.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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

Description

De cmdlet Add-AzureRmVMNetworkInterface 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

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"

Met de eerste opdracht wordt een virtuele-machineobject gemaakt en vervolgens opgeslagen in de $VirtualMachine variabele. 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

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

Met de eerste opdracht wordt de virtuele machine met de naam VirtualMachine07 opgehaald met behulp van de Cmdlet Get-AzureRmVM . 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 die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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-AzureRmNetworkInterface gebruiken om een netwerkinterface te verkrijgen.

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

-NetworkInterface

Hiermee geeft u de netwerkinterface.

Type:List<T>[INetworkInterfaceReference]
Position:1
Default value:None
Required:True
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Hiermee geeft u een lokale virtuele-machineobject waaraan een netwerkinterface moet worden toegevoegd. Als u een virtuele machine wilt maken, gebruikt u de cmdlet New-AzureRmVMConfig . Gebruik de cmdlet Get-AzureRmVM om een bestaande virtuele machine op te halen.

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

Invoerwaarden

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

Uitvoerwaarden

PSVirtualMachine