Disconnect-CisServer Command | Vmware PowerCLI Reference

Disconnect-CisServer

This cmdlet closes the connection to one or more vSphere Automation SDK servers.When no servers and no user name are specified, and if there is only one connected server in $DefaultCisServers variable, this server is disconnected. If there is no connected server, the cmdlet throws a terminating error.This functionality is using the reference counting mechanism. For more information about the mechanism, see Connect-CisServer.When there are no more active connections to the server it gets disconnected and then it is removed from the $DefaultCisServers variable. For more information about this variable, see Connect-CisServer.If -Force is specified, the server is disconnected even if there is more than one connection to it.

Syntax

Disconnect-CisServer
[-Force ]
[-Server < CisServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
optional Force SwitchParameter named
Specifies that you want to remove all existing connections to the specified servers.
optional Server CisServer[] named
  • pipeline
  • wildcards
Specifies the vSphere Automation SDK servers you want to disconnect from.

Output

Examples

Example 1

$server = Connect-CisServer -Server 'server_name' -User 'user@domain' -Password 'user_password'
Disconnect-CisServer $server -Confirm:$false

Disconnects the specified vSphere Automation SDK server without asking for confirmation.

Example 2

Connect-CisServer -Server 'server_name' -User 'user@domain' -Password 'user_password'
Connect-CisServer -Server 'server2_name' -User 'user@domain' -Password 'user_password'
Disconnect-CisServer * -Confirm:$false

Disconnects all connected vSphere Automation SDK servers without asking for confirmation.

Related Commands

CisServer

This cmdlet establishes a connection to a vSphere Automation SDK server.

This cmdlet closes the connection to one or more vSphere Automation SDK servers.