Functions/Public/Disconnect-vRAServer.ps1
|
function Disconnect-vRAServer { <# .SYNOPSIS Disconnect from a vRA server .DESCRIPTION Disconnect from a vRA server by removing the authorization token and the global vRAConnection variable from PowerShell .EXAMPLE Disconnect-vRAServer .EXAMPLE Disconnect-vRAServer -Confirm:$false #> [CmdletBinding(SupportsShouldProcess,ConfirmImpact="High")] Param () # --- Test for existing connection to vRA if (-not $Global:vRAConnection){ throw "vRA Connection variable does not exist. Please run Connect-vRAServer first to create it" } if ($PSCmdlet.ShouldProcess($Global:vRAConnection.Server)){ try { # --- Remove the token from vRA and remove the global PowerShell variable $URI = "/identity/api/tokens/$($Global:vRAConnection.Token)" Write-Verbose -Message "Preparing DELETE to $($URI)" $Response = Invoke-vRARestMethod -Method DELETE -URI $URI } catch [Exception]{ throw } finally { Write-Verbose -Message "Removing vRAConnection global variable" Remove-Variable -Name vRAConnection -Scope Global -Force -ErrorAction SilentlyContinue } } } |