Using the Disconnect-Client Command

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).


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


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.


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