Disconnects a client from a multicast transmission or namespace.

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

[/Server:<Server name>]

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

[/Force]

Stops the installation completely and does not use a fallback method. Note that if you do not use this option, the default behavior is as follows:

  • If you are using the Windows Deployment Services client, the client will continue with the installation, using the Server Message Block (SMB) protocol.

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

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