Edit

wdsutil disconnect-client

  • Article

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

Syntax

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

Parameters

Parameter Description
/ClientId:<ClientID> Specifies the ID of the client to be disconnected. To view the ID of a client, run the wdsutil /get-multicasttransmission /show:clients command.
[/Server:<Servername>] 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. Because Wdsmcast.exe doesn't support any fallback mechanism, the default behavior is as follows:
  • If you're using the Windows Deployment Services client: The client continues the installation by using unicasting.
  • If you aren't using the Windows Deployment Services client: The installation fails.
Important: We strongly recommend using this parameter cautiously because if the installation fails, the computer can 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