Add-ContainerNetworkAdapter

[アーティクル]
11/16/2015

Add-ContainerNetworkAdapter

Adds a virtual network adapter to a container.

構文

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

詳細説明

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

パラメーター

-CimSession<CimSession[]>

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

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	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.

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Container<Container[]>

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

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true(ByValue)
ワイルドカード文字の受け入れ	false

-ContainerName<String[]>

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

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true(ByValue)
ワイルドカード文字の受け入れ	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

-DynamicMacAddress

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

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Name<String>

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

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-Passthru

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

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-StaticMacAddress<String>

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

Aliases	none
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	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.

Aliases	none
必須/オプション	false
位置	named
既定値	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: 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