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

[-Force]
[-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
Server
VIServer[] named
  • wildcards
  • pipeline
  • 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

    Feedback

    Was this page helpful?