Publish Pre-release (#1)

* adds basic module layout * fix module manifest encoding * fix callsign in appveyor helper * adds challenge file related functions * adds connection manager functions * adds Test-ChallengeFile * adds item related functions * adds store related functions * adds cSpell dictionary * adds CredentialStore related Pester tests * [WIP] test Pester file * fix typo * adds file dependencies * [WIP] fix pester tests * fix exception state * [WIP] add file dependencies * fix gitkeep filename * set constant debug module version string * adds Pester Tests for New-CredentialStoreItem * adds basic readme file * adds functions to export; adds meta data * adds vscode debug config * adds test for optional dependencies * [WIP] Implements optional dependency test * adds taskrunner definitions * adds CBH * add gitignore file * adds basic Build tasks * typo fixed * adds build folder to ignore list * adds Cisco and NetApp opt dependencies * adds build task * fix end of line dequence * remove task.json error * adds sources for optional modules * enables Pester and posh-git * prepare pre-release
2017-09-21 13:32:15 +02:00
parent 5ebba20cea
commit 64af16cc08
37 changed files with 2503 additions and 1 deletions
--- a/src/Connection/Disconnect-From.ps1
+++ b/src/Connection/Disconnect-From.ps1
@ -0,0 +1,147 @@
+function Disconnect-From {
+    <#
+    .SYNOPSIS
+        Terminates a session established with Connect-To using a CredentialStoreItem.
+
+    .DESCRIPTION
+        Terminates a session established with Connect-To using a CredentialStoreItem.
+
+    .PARAMETER RemoteHost
+        Specify the remote endpoint, whose session you would like to terminate.
+
+    .PARAMETER Identifier
+        Defaults to "". Specify a string, which separates two CredentialStoreItems for the
+        same hostname.
+
+    .PARAMETER Type
+        Specify the host type of the target. Currently implemented targets are:
+            - CiscoUcs     Establish a connection to a Cisco UCS Fabric Interconnect.
+            - FTP          Establish a connection to a FTP host.
+            - NetAppFAS    Establish a connection to a NetApp Clustered ONTAP filer.
+            - VMware       Establish a connection to a VMware vCenter or ESXi host.
+
+    .PARAMETER Force
+        Force the disconnect, even if the disconnect would fail.
+
+    .INPUTS
+        [None]
+
+    .OUTPUTS
+        [None]
+
+    .EXAMPLE
+        Disconnect-From -RemoteHost "ucs.myside.local" -Type CiscoUcs
+
+    .EXAMPLE
+        Disconnect-From -RemoteHost "ftp.myside.local" -Type FTP
+
+    .EXAMPLE
+        Disconnect-From -RemoteHost "fas.myside.local" -Type NetAppFAS
+
+    .EXAMPLE
+        Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware
+
+    .EXAMPLE
+        Disconnect-From -RemoteHost "esx01.myside.local" -Type VMware -Force:$True
+
+    .NOTES
+        File Name   : Disconnect-To.ps1
+        Author      : Marco Blessing - marco.blessing@googlemail.com
+        Requires    :
+
+    .LINK
+        https://github.com/OCram85/PSCredentialStore
+    #>
+
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$RemoteHost,
+
+        [Parameter(Mandatory = $true)]
+        [ValidateSet("CiscoUcs", "FTP", "NetAppFAS", "VMware")]
+        [string]$Type,
+
+        [Parameter(Mandatory = $false)]
+        [switch]$Force
+    )
+
+    switch ($Type) {
+        "VMware" {
+            try {
+                if ($Force) {
+                    Disconnect-VIServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop -Force:$true
+                }
+                else {
+                    Disconnect-VIServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop
+                }
+            }
+
+            catch {
+                # Write a error message to the log.
+                $MessageParams = @{
+                    Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type
+                    ErrorAction = "Stop"
+                }
+                Write-Error @MessageParams
+            }
+
+        }
+        # Check for an existing WinSCP Session var
+        "FTP" {
+            if ($Global:WinSCPSession.Opened) {
+                Remove-WinSCPSession -WinSCPSession $Global:WinSCPSession
+            }
+            else {
+                $MessageParams = @{
+                    Message = "There is no open WinSCP Session"
+                    ErrorAction = "Stop"
+                }
+                Write-Error @MessageParams
+            }
+        }
+        # DataONTAP doesn't have a CmdLet `Disconnect-NcController`.
+        # So we go ahead and clear the CurrentNcController variable.
+        "NetAppFAS" {
+            try {
+                $MessageParams = @{
+                    Message = "Setting {0} to `$null, which will disconnect NetAppFAS" -f $Global:CurrentNcController
+                    ErrorAction = "Continue"
+                }
+                Write-Verbose @MessageParams
+                $Global:CurrentNcController = $null
+            }
+            catch {
+                # Write a error message to the log.
+                $MessageParams = @{
+                    Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type
+                    ErrorAction = "Stop"
+                }
+                Write-Error @MessageParams
+            }
+
+        }
+        "CiscoUcs" {
+            try {
+                Disconnect-Ucs -Ucs $RemoteHost
+            }
+
+            catch {
+                # Write a error message to the log.
+                $MessageParams = @{
+                    Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type
+                    ErrorAction = "Stop"
+                }
+                Write-Error @MessageParams
+            }
+        }
+        default {
+            # Write a error message to the log.
+            $MessageParams = @{
+                Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type
+                ErrorAction = "Stop"
+            }
+            Write-Error @MessageParams
+        }
+    }
+}