Disconnect-VIServer
This cmdlet closes the connection to a vCenter Server system. In PowerCLI, you can have multiple connections to a server. In order to disconnect from a server, you must close all active connections to it. By default, Disconnect-VIServer closes only the last connection to the specified server. To close all active connections to a server, use the Force parameter or run the cmdlet for each connection. When a server is disconnected, it is removed from the default servers list. For more information about default servers, see the description of Connect-VIServer.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| optional | Force | SwitchParameter | named |
|
Indicates that you want to close all active connections to the specified server and disconnect from it. If the value is $false, the cmdlet closes only the last connection to the specified server and you must run Disconnect-VIServer for each active connection to this server in order to disconnect from it. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems you want to disconnect from. |
Output
Examples
Example 1
$Server = Connect-VIServer 10.23.112.235 Disconnect-VIServer -Server $Server
Connects to a server with an IP address 10.23.112.235 and saves the returned VIServer object in the $Server variable. Then disconnects from the specified server.
Example 2
Disconnect-VIServer -Server $global:DefaultVIServers -Force
Closes all connections to the default servers.
Example 3
Disconnect-VIServer -Server * -Force
Disconnects all server connections.
Related Commands
VIServer
This cmdlet establishes a connection to a vCenter Server system.
This cmdlet closes the connection to a vCenter Server system.