Dela via

Add-AzureRmVMNetworkInterface

  • Referens
Modul:
AzureRM.Compute

Lägger till ett nätverksgränssnitt i en virtuell dator.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Add-AzureRmVMNetworkInterface lägger till ett nätverksgränssnitt till en virtuell dator. Du kan lägga till ett gränssnitt när du skapar en virtuell dator eller lägger till en i en befintlig virtuell dator.

Exempel

Exempel 1: Lägga till ett nätverksgränssnitt till en ny virtuell dator

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"

Det första kommandot skapar ett virtuellt datorobjekt och lagrar det sedan i variabeln $VirtualMachine. Kommandot tilldelar ett namn och en storlek till den virtuella datorn. Det andra kommandot lägger till ett nätverksgränssnitt till den virtuella datorn som lagras i $VirtualMachine.

Exempel 2: Lägga till ett nätverksgränssnitt till en befintlig virtuell dator

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

Det första kommandot hämtar den virtuella datorn med namnet VirtualMachine07 med hjälp av cmdleten Get-AzureRmVM . Kommandot lagrar den virtuella datorn i variabeln $VirtualMachine. Det andra kommandot lägger till ett nätverksgränssnitt till den virtuella datorn som lagras i $VirtualMachine. Det sista kommandot uppdaterar tillståndet för den virtuella datorn som lagras i $VirtualMachine i ResourceGroup11.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-Id

Anger ID för ett nätverksgränssnitt som ska läggas till i en virtuell dator. Du kan använda cmdleten Get-AzureRmNetworkInterface för att hämta ett nätverksgränssnitt.

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

-NetworkInterface

Anger nätverksgränssnittet.

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

-Primary

Anger att den här cmdleten lägger till nätverksgränssnittet som primärt gränssnitt.

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

-VM

Anger ett lokalt virtuellt datorobjekt som du vill lägga till ett nätverksgränssnitt till. Om du vill skapa en virtuell dator använder du cmdleten New-AzureRmVMConfig . Om du vill hämta en befintlig virtuell dator använder du cmdleten Get-AzureRmVM .

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

Indata

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

Utdata

PSVirtualMachine