Add-ContainerNetworkAdapter

Artikel
11/16/2015

Add-ContainerNetworkAdapter

Adds a virtual network adapter to a container.

Syntax

Parameter Set: Container Name
Add-ContainerNetworkAdapter [-ContainerName] <String[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-DynamicMacAddress] [-Name <String> ] [-Passthru] [-StaticMacAddress <String> ] [-SwitchName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Container Object
Add-ContainerNetworkAdapter [-Container] <Container[]> [-DynamicMacAddress] [-Name <String> ] [-Passthru] [-StaticMacAddress <String> ] [-SwitchName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

The Add-ContainerNetworkAdapter cmdlet adds a virtual network adapter to a container.

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 one or more Hyper-V hosts to run the cmdlet. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer. Use "localhost" or a dot (".") to specify the local computer explicitly.

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

-Container<Container[]>

Specifies the container to which this cmdlet adds a network adapter.

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

-ContainerName<String[]>

Specifies the name of the container to which this cmdlet adds a network adapter.

Aliase	none
Erforderlich?	true
Position?	1
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByValue)
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

-DynamicMacAddress

Specifies whether this cmdlet assigns a dynamically generated MAC address to the new virtual network adapter.

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

-Name<String>

Specifies a name for the new virtual network adapter. The default value is "Network Adapter."

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
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

-StaticMacAddress<String>

Specifies a specific MAC address to assign to the new virtual network adapter.

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

-SwitchName<String>

Specifies the name of the virtual switch to connect to the new network adapter. If the switch name is not unique, then the operation fails.

Aliase	none
Erforderlich?	false
Position?	named
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: Add a virtual network adapter to a container

This command adds a virtual network adapter named Nic1 to a container named Container01.

PS C:\> Add-ContainerNetworkAdatper -ContainerName "Container01" -Name "Nic1"

Example 2: Add a virtual network to a container and connect it to a virtual switch

This command adds a virtual network adapter to a container named Container01 and connects it to a virtual switch named Network.

PS C:\> Add-ContainerNetworkAdapter -ContainerName "Container01" -SwitchName "Network"

Add-ContainerNetworkAdapter