Disconnect-VIServer Command | Vmware PowerCLI Reference

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

Disconnect-VIServer
[-Force ]
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[CommonParameters]

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
  • pipeline
  • wildcards
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.