Also update the docs and Disconnect-From

This commit is contained in:
admwkiv839 2022-06-16 08:45:00 +02:00
parent 3922815bff
commit a2856ee50b
2 changed files with 74 additions and 48 deletions

View File

@ -14,8 +14,16 @@ function Connect-To {
same hostname. same hostname.
.PARAMETER Type .PARAMETER Type
Specify the host type of the target. Currently implemented targets are: Possible connection values are: Specify the host type of the target. Currently implemented targets are:
CiscoUcs, FTP, NetAppFAS, VMware, CisServer, ExchangeHTTP, ExchangeHTTPS, SCP. - CiscoUcs
- CiscoUcsCentral
- CisServer
- ExchangeHTTP
- ExchangeHTTPS
- FTP
- NetAppFAS
- SCP
- VMware
.PARAMETER Credentials .PARAMETER Credentials
Use this parameter to bypass the stored credentials. Without this parameter Connect-To tries to read the Use this parameter to bypass the stored credentials. Without this parameter Connect-To tries to read the
@ -41,6 +49,9 @@ function Connect-To {
.EXAMPLE .EXAMPLE
Connect-To -RemoteHost "ucs.myside.local" -Type CiscoUcs Connect-To -RemoteHost "ucs.myside.local" -Type CiscoUcs
.EXAMPLE
Connect-To -RemoteHost "ucscentral.myside.local" -Type 'CiscoUcsCentral'
.EXAMPLE .EXAMPLE
Connect-To -RemoteHost "ftp.myside.local" -Type FTP Connect-To -RemoteHost "ftp.myside.local" -Type FTP
@ -82,13 +93,14 @@ function Connect-To {
[Parameter(Mandatory = $true, ParameterSetName = "Private")] [Parameter(Mandatory = $true, ParameterSetName = "Private")]
[ValidateSet( [ValidateSet(
'CiscoUcs', 'CiscoUcs',
'FTP', 'CiscoUcsCentral',
'NetAppFAS',
'VMware',
'CisServer', 'CisServer',
'ExchangeHTTP', 'ExchangeHTTP',
'ExchangeHTTPS', 'ExchangeHTTPS',
'SCP' 'FTP',
'NetAppFAS',
'SCP',
'VMware'
)] )]
[string]$Type, [string]$Type,

View File

@ -14,8 +14,16 @@ function Disconnect-From {
same hostname. same hostname.
.PARAMETER Type .PARAMETER Type
Specify the host type of the target. Currently implemented targets are: CiscoUcs, FTP, NetAppFAS, VMware, Specify the host type of the target. Currently implemented targets are:
CisServer, ExchangeHTTP, ExchangeHTTPS, SCP. - CiscoUcs
- CiscoUcsCentral
- CisServer
- ExchangeHTTP
- ExchangeHTTPS
- FTP
- NetAppFAS
- SCP
- VMware
.PARAMETER Force .PARAMETER Force
Force the disconnect, even if the disconnect would fail. Force the disconnect, even if the disconnect would fail.
@ -29,6 +37,9 @@ function Disconnect-From {
.EXAMPLE .EXAMPLE
Disconnect-From -RemoteHost "ucs.myside.local" -Type CiscoUcs Disconnect-From -RemoteHost "ucs.myside.local" -Type CiscoUcs
.EXAMPLE
Disconnect-From -RemoteHost "ucscentral.myside.local" -Type 'CiscoUcsCentral'
.EXAMPLE .EXAMPLE
Disconnect-From -RemoteHost "ftp.myside.local" -Type FTP Disconnect-From -RemoteHost "ftp.myside.local" -Type FTP
@ -67,13 +78,14 @@ function Disconnect-From {
[Parameter(Mandatory = $true)] [Parameter(Mandatory = $true)]
[ValidateSet( [ValidateSet(
'CiscoUcs', 'CiscoUcs',
'FTP', 'CiscoUcsCentral',
'NetAppFAS',
'VMware',
'CisServer', 'CisServer',
'ExchangeHTTP', 'ExchangeHTTP',
'ExchangeHTTPS', 'ExchangeHTTPS',
'SCP' 'FTP',
'NetAppFAS',
'SCP',
'VMware'
)] )]
[string]$Type, [string]$Type,
@ -81,43 +93,43 @@ function Disconnect-From {
[switch]$Force [switch]$Force
) )
# Set defaults for the preference variables.
$InformationPreference = 'Continue'
$ErrorActionPreference = 'Stop'
$ProgressPreference = 'SilentlyContinue'
switch -Regex ($Type) { switch -Regex ($Type) {
"VMware" { "VMware" {
try { try {
if ($Force) { if ($Force) {
Disconnect-VIServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop -Force:$true Disconnect-VIServer -Server $RemoteHost -Confirm:$false -Force:$true
} }
else { else {
Disconnect-VIServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop Disconnect-VIServer -Server $RemoteHost -Confirm:$false
} }
} }
catch { catch {
# Write a error message to the log. # Write a error message to the log.
$MessageParams = @{ $_.Exception.Message | Write-Warning
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
ErrorAction = "Stop"
}
Write-Error @MessageParams
} }
} }
"CisServer" { "CisServer" {
try { try {
if ($Force) { if ($Force) {
Disconnect-CisServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop -Force:$true Disconnect-CisServer -Server $RemoteHost -Confirm:$false -Force:$true
} }
else { else {
Disconnect-CisServer -Server $RemoteHost -Confirm:$false -ErrorAction Stop Disconnect-CisServer -Server $RemoteHost -Confirm:$false
} }
} }
catch { catch {
# Write a error message to the log. # Write a error message to the log.
$MessageParams = @{ $_.Exception.Message | Write-Warning
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
ErrorAction = "Stop"
}
Write-Error @MessageParams
} }
} }
# Check for an existing WinSCP Session var # Check for an existing WinSCP Session var
@ -147,11 +159,8 @@ function Disconnect-From {
catch { catch {
# Write a error message to the log. # Write a error message to the log.
$MessageParams = @{ $_.Exception.Message | Write-Warning
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
ErrorAction = "Stop"
}
Write-Error @MessageParams
} }
} }
@ -162,24 +171,33 @@ function Disconnect-From {
catch { catch {
# Write a error message to the log. # Write a error message to the log.
$MessageParams = @{ $_.Exception.Message | Write-Warning
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
ErrorAction = "Stop"
}
Write-Error @MessageParams
} }
} }
'CiscoUcsCentral' {
try {
Disconnect-UcsCentral -Ucs $RemoteHost
}
catch {
# Write a error message to the log.
$_.Exception.Message | Write-Warning
Write-Error -Message ('Unable to disconnect from {0} using Type {1}.' -f $RemoteHost, $Type)
}
}
"ExchangeHTTP*" { "ExchangeHTTP*" {
try { try {
Get-Variable -Name 'PSExchangeRemote' -Scope Global -ErrorAction Stop Get-Variable -Name 'PSExchangeRemote' -Scope Global
Remove-PSSession -Session $Global:PSExchangeRemote -ErrorAction Stop Remove-PSSession -Session $Global:PSExchangeRemote
} }
catch { catch {
$MessageParams = @{ # Write a error message to the log.
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type $_.Exception.Message | Write-Warning
ErrorAction = "Stop" Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
}
Write-Error @MessageParams
} }
} }
"SCP" { "SCP" {
@ -196,11 +214,7 @@ function Disconnect-From {
} }
default { default {
# Write a error message to the log. # Write a error message to the log.
$MessageParams = @{ Write-Error -Message ("Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type)
Message = "Unable to disconnect from {0} using Type {1}." -f $RemoteHost, $Type
ErrorAction = "Stop"
}
Write-Error @MessageParams
} }
} }
} }