Dela via


Add-AzVMNetworkInterface

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

Syntax

Add-AzVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-Id] <String>
   [-Primary]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
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.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DeleteOption

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Alias:NicId, NetworkInterfaceId
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NetworkInterface

Anger nätverksgränssnittet.

Typ:List<T>[INetworkInterfaceReference]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Primary

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

Typ:SwitchParameter
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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 .

Typ:PSVirtualMachine
Alias:VMProfile
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

SwitchParameter

Utdata

PSVirtualMachine