Dela via


Add-AzVMNetworkInterface

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

Syntax

GetNicFromNicId (Standard)

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

Cmdleten Add-AzVMNetworkInterface 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

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

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

$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

Det första kommandot hämtar den virtuella datorn med namnet VirtualMachine07 med hjälp av Cmdleten Get-AzVM . 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.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DeleteOption

Anger borttagningsalternativet för nätverksgränssnittet efter att den virtuella datorn har tagits bort. Alternativen är Koppla från, Ta bort

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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-AzNetworkInterface för att hämta ett nätverksgränssnitt.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:NicId, NetworkInterfaceId

Parameteruppsättningar

GetNicFromNicId
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NetworkInterface

Anger nätverksgränssnittet.

Parameteregenskaper

Typ:

List<T>[INetworkInterfaceReference]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

GetNicFromNicObject
Position:1
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Primary

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

GetNicFromNicId
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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-AzVMConfig . Om du vill hämta en befintlig virtuell dator använder du cmdleten Get-AzVM .

Parameteregenskaper

Typ:PSVirtualMachine
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:VMProfile

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSVirtualMachine

String

List<T>

SwitchParameter

Utdata

PSVirtualMachine