Add-AzVMNetworkInterface
Hiermee voegt u een netwerkinterface aan een virtuele machine toe.
Syntaxis
Add-AzVMNetworkInterface
[-VM] <PSVirtualMachine>
[-Id] <String>
[-Primary]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzVMNetworkInterface
[-VM] <PSVirtualMachine>
[-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
[-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
PS C:\> $VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> 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
PS C:\> $VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
PS C:\> 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.
Type: | IAzureContextContainer |
Aliassen: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Aliassen: | NicId, NetworkInterfaceId |
Position: | 1 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-NetworkInterface
Hiermee geeft u de netwerkinterface.
Type: | List<T>[INetworkInterfaceReference] |
Position: | 1 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Primary
Geeft aan dat met deze cmdlet de netwerkinterface wordt toegevoegd als de primaire interface.
Type: | SwitchParameter |
Position: | 2 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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.
Type: | PSVirtualMachine |
Aliassen: | VMProfile |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
Invoerwaarden
De parameter NetworkInterface accepteert de waarde van het type System.Collections.Generic.List'1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterface] uit de pijplijn
PSVirtualMachine
De parameter VM accepteert de waarde van het type PSVirtualMachine uit de pijplijn