Delen via

Add-AzVMNetworkInterface

Module:
Az.Compute Module

Hiermee voegt u een netwerkinterface toe aan een virtuele machine.

Syntax

GetNicFromNicId (Standaard) 

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

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

$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

Met de eerste opdracht wordt de virtuele machine met de naam VirtualMachine07 opgehaald met behulp van de Cmdlet Get-AzVM . 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.

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DeleteOption

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:NicId, NetworkInterfaceId

Parametersets

GetNicFromNicId
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NetworkInterface

Hiermee geeft u de netwerkinterface.

Parametereigenschappen

Type:

List<T>[INetworkInterfaceReference]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetNicFromNicObject
Position:1
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Primary

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetNicFromNicId
Position:2
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-VM

Hiermee geeft u een lokale virtuele-machineobject waaraan een netwerkinterface moet worden toegevoegd. Gebruik de cmdlet New-AzVMConfig om een virtuele machine te maken. Gebruik de Cmdlet Get-AzVM om een bestaande virtuele machine op te halen.

Parametereigenschappen

Type:PSVirtualMachine
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:VMProfile

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSVirtualMachine

String

List<T>

SwitchParameter

Uitvoerwaarden

PSVirtualMachine