/disconnect-Client

Applies To: Windows Server 2008, Windows Server 2008 R2

Disconnects a client from a multicast transmission or namespace. Unless you specify /Force, the client will fall back to another transfer method (if it is supported by the client).

Syntax

WDSUTIL /Disconnect-Client /ClientId:<Client ID> [/Server:<Server name>] [/Force]

Parameters

Parameter Description

/ClientId:<Client ID>

Specifies the ID of the client to be disconnected. To view the ID of a client, type WDSUTIL /get-multicasttransmission /show:clients.

[/Server:<Server name>]

Specifies the name of the server. This can be the NetBIOS name or the fully qualified domain name (FQDN). If no server name is specified, the local server is used.

[/Force]

Stops the installation completely and does not use a fallback method. Note that Wdsmcast.exe does not support any fallback mechanism. If you do not use this option, the default behavior is as follows:

  • If you are using the Windows Deployment Services client, the client continues the installation by using unicasting.

  • If you are not using the Windows Deployment Services client, the installation fails.

Important
You should use this option with caution because the installation will fail and the computer could be left in an unusable state.

Examples

To disconnect a client, type:

WDSUTIL /Disconnect-Client /ClientId:1

To disconnect a client and force the installation to fail, type:

WDSUTIL /Disconnect-Client /Server:MyWDSServer /ClientId:1 /Force

Additional references

Command-Line Syntax Key