Connect-ContainerNetworkAdapter

Artikel
11/16/2015

Connect-ContainerNetworkAdapter

Connects a virtual network adapter to a virtual switch.

Syntax

Parameter Set: Name_SwitchName
Connect-ContainerNetworkAdapter [-ContainerName] <String[]> [[-Name] <String[]> ] [-SwitchName] <String> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Object_SwitchName
Connect-ContainerNetworkAdapter [-NetworkAdapter] <ContainerNetworkAdapter[]> [-SwitchName] <String> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

The Connect-ContainerNetworkAdapter cmdlet connects a virtual network adapter to a virtual switch.

Parameter

-CimSession<CimSession[]>

Das Cmdlet wird in einer Remotesitzung oder auf einem Remotecomputer ausgeführt. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, wie z. B. die Ausgabe eines New-CimSession oder Get-CimSession-Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ComputerName<String[]>

Specifies the name of the computer.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ContainerName<String[]>

Specifies the name of the container to which the network adapter is to be connected.

Aliase	none
Erforderlich?	true
Position?	1
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Credential<PSCredential[]>

Specifies a user account that has permission to perform this action. The default is the current user.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Name<String[]>

Specifies the name of the virtual network adapter that this cmdlet connects to a switch.

Aliase	none
Erforderlich?	false
Position?	2
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-NetworkAdapter<ContainerNetworkAdapter[]>

Specifies the virtual network adapter that this cmdlet connects to a switch.

Aliase	none
Erforderlich?	true
Position?	1
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByValue)
Platzhalterzeichen akzeptieren?	false

-Passthru

Gibt ein Objekt an, das das Element darstellt, mit dem Sie arbeiten. Dieses Cmdlet generiert standardmäßig keine Ausgabe.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-SwitchName<String>

Specifies the name of the virtual switch to which the virtual network adapter is to be connected.

Aliase	none
Erforderlich?	true
Position?	3
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Confirm

Fordert Sie vor der Ausführung des Cmdlet zum Bestätigen auf.

Erforderlich?	false
Position?	named
Standardwert	false
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WhatIf

Zeit, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Erforderlich?	false
Position?	named
Standardwert	false
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

Beispiele

Example 1: Connect a virtual network adapter to a virtual switch

This command connects a virtual network adapter named Internet in the containers named Test1 and Test2 to a virtual switch InternetAccess

PS C:\> Connect-ContainerNetworkAdapter -ContainerName Test1,Test2 -Name Internet -SwitchName InternetAccess

Example 2: Connect a virtual network adapter to a virtual switch by getting its network adapter object

This command connects a virtual network adapter in the container named Containeer01 to the virtual switch named InternetAccess.

PS C:\> Get-ContainerNetworkAdapter -ContainerName "Container01" | Connect-ContainerNetworkAdapter -SwitchName "InternetAccess"

Example 3: Connect a virtual network adaptner to a switch

This command connects a virtual network adapter in the container named Container01 to the switch named InternetAccess

PS C:\> Get-VMSwitch "InternetAccess" | Connect-ContainerNetworkAdapter -ContainerName "Container01"

Connect-ContainerNetworkAdapter