Connect-ContainerNetworkAdapter

Connect-ContainerNetworkAdapter

Connects a virtual network adapter to a virtual switch.

構文

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>]

詳細説明

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

パラメーター

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。コンピューター名またはセッション オブジェクト (New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など) を入力します。既定値は、ローカル コンピューター上の現在のセッションです。

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-ComputerName<String[]>

Specifies the name of the computer.

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-ContainerName<String[]>

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

Aliases

none

必須/オプション

true

位置

1

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Credential<PSCredential[]>

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

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Name<String[]>

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

Aliases

none

必須/オプション

false

位置

2

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-NetworkAdapter<ContainerNetworkAdapter[]>

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

Aliases

none

必須/オプション

true

位置

1

既定値

none

パイプライン入力の受け入れ

true(ByValue)

ワイルドカード文字の受け入れ

false

-Passthru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットから出力は生成されません。

Aliases

none

必須/オプション

false

位置

named

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-SwitchName<String>

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

Aliases

none

必須/オプション

true

位置

3

既定値

none

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

必須/オプション

false

位置

named

既定値

false

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

必須/オプション

false

位置

named

既定値

false

パイプライン入力の受け入れ

false

ワイルドカード文字の受け入れ

false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

  • Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

    Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

使用例

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"                        

関連項目

Add-ContainerNetworkAdapter

Disconnect-ContainerNetworkAdapter

Get-ContainerNetworkAdapter

Remove-ContainerNetworkAdapter

Set-ContainerNetworkAdapter