Share via


Disconnect-ContainerNetworkAdapter

Disconnect-ContainerNetworkAdapter

Disconnects a virtual network adapter from a virtual switch.

語法

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

Parameter Set: ResourceObject
Disconnect-ContainerNetworkAdapter [-NetworkAdapter] <ContainerNetworkAdapter[]> [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Disconnect-ContainerNetworkAdapter cmdlet disconnects a virtual network adapter from a virtual switch.

參數

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件,例如 New-CimSessionGet-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。

別名

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.

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-ContainerName<String[]>

Specifies the name of the container in which the virtual network adapter is to be disconnected.

別名

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.

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Name<String[]>

Specifies the name of the virtual network adapter that this cmdlet disconnects from a virtual switch.

別名

none

必要項?

false

位置?

2

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-NetworkAdapter<ContainerNetworkAdapter[]>

Specifies the virtual network adapter that this cmdlet disconnects from a virtual switch.

別名

none

必要項?

true

位置?

1

預設值

none

接受管線輸入?

true (ByValue)

接受萬用字元?

false

-Passthru

傳回物件,表示您所使用的項目。此 Cmdlet 依預設不會產生任何輸出。

別名

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。如需詳細資訊,請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是可透過管道傳送至指令程式的物件類型。

輸出

輸出類型是指令程式所發出的物件類型。

  • Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

    Microsoft.Containers.PowerShell.Objects.ContainerNetworkAdapter

範例

Example 1: Disconnect a virtual network adapter

This command disconnects a virtual network adapter named Network01.

PS C:\> Disconnect-ContainerNetworkAdapter -NetworkAdapter "Network01"                        

Example 2: Disconnect all virtual network adapters connected to a switch

This command disconnects all virtual network adapters that are connected to a switch named InternetAccess in all containers on the host.

PS C:\> Get-ContainerNetworkAdapter -ContainerName * | Where-Object {$_.SwitchName -eq 'InternetAccess'} | Disconnect-ContainerNetworkAdapter                

相關主題

Add-ContainerNetworkAdapter

Connect-ContainerNetworkAdapter

Get-ContainerNetworkAdapter

Remove-ContainerNetworkAdapter

Set-ContainerNetworkAdapter