Public/Disconnect-Unity.ps1

Function Disconnect-Unity {

  <#
      .SYNOPSIS
      Disconnects from an EMC Unity Array
      .DESCRIPTION
      Disconnects from an EMC Unity Array. By default, Disconnect-Unity closes all sessions. To close a specific session, use the -Session parameter.
      When a session is disconnected, it is removed form the default array list.
      .NOTES
      Written by Erwan Quelin under MIT licence - https://github.com/equelin/Unity-Powershell/blob/master/LICENSE
      .LINK
      https://github.com/equelin/Unity-Powershell
      .PARAMETER Session
      Specifies an UnitySession Object.
      .EXAMPLE
      Disconnect-Unity

      Disconnects all the sessions
      .EXAMPLE
      $Session = Get-UnitySession -Server 192.0.2.1
      Disconnect-Unity -Session $Session

      Disconnects all the sessions matching the IP of the array 192.0.2.1

  #>


  [CmdletBinding(SupportsShouldProcess = $True,ConfirmImpact = 'High')]
  Param (
    [Parameter(Mandatory = $false,ValueFromPipeline=$True,ValueFromPipelinebyPropertyName=$True,HelpMessage = 'EMC Unity Session')]
    $session = $global:DefaultUnitySession
  )
  Begin {
    Write-Debug -Message "[$($MyInvocation.MyCommand)] Executing function"
  }

  Process {
    Foreach ($sess in $session) {

      Write-Verbose "Processing session with array: $($sess.Server) and SessionID: $($sess.SessionID) "

      If ($Sess.IsConnected -eq $false) {

        Write-Verbose "Session already disconnected. Delete it from DefaultUnitySession"
        $global:DefaultUnitySession = $global:DefaultUnitySession | where-object {$_.SessionId -notmatch $Sess.SessionId}

      } else {

        #Building URI
        $uri = 'https://'+$sess.Server+'/api/types/loginSessionInfo/action/logout'

        Write-Verbose "URI: $URI"

        Write-Verbose "Disconnecting session $($sess.SessionID)"

        if ($pscmdlet.ShouldProcess($sess.Server,"Disconnecting from Unity Array")) {

          #Sending request
          $request = Invoke-WebRequest -Uri $URI -ContentType "application/json" -Websession $sess.Websession -Headers $sess.headers -Method POST -UseBasicParsing

          If ($request.StatusCode -eq 200) {
            Write-Verbose "Delete session from DefaultUnitySession"
            $global:DefaultUnitySession = $global:DefaultUnitySession | where-object {$_.SessionId -notmatch $Sess.SessionId}
          }
        }
      }
    }
  }

  End {
    ## update the Windows PowerShell titlebar with a bit of info about the Unity array(s) to which the PowerShell session is connected
    Update-TitleBarForUnityConnection
  }
}