Functions/Public/Get-AMConnection.ps1
|
function Get-AMConnection { <# .SYNOPSIS Gets current Automate connections. .DESCRIPTION Get-AMConnection gets a list of current connections to Automate. .PARAMETER Connection The connection name(s) or object(s). .PARAMETER ConnectionAlias The connection alias name. .INPUTS Connection, String .OUTPUTS Connection .EXAMPLE $connection = Connect-AMServer "automate01" Get-AMConnection -Connection $connection .EXAMPLE Connect-AMServer "automate01" -ConnectionAlias "prod" Get-AMConnection -Connection "prod" .LINK https://github.com/AutomatePS/AutomatePS/blob/master/Docs/Get-AMConnection.md #> [CmdletBinding(DefaultParameterSetName="AllConnections")] [OutputType([AMConnection])] param ( [Alias("ConnectionAlias")] [Parameter(ParameterSetName = "ByConnection")] [ArgumentCompleter([AMConnectionCompleter])] [ValidateNotNullOrEmpty()] $Connection ) Process { switch ($PSCmdlet.ParameterSetName) { "AllConnections" { $connections = $global:AMConnections } "ByConnection" { if ($Connection -is [string]) { $connections = $global:AMConnections | Where-Object {$_.Alias -eq $Connection} } elseif ($Connection -is [AMConnection]) { $connections = $Connection } elseif ($Connection -is [array]) { $connections = @() foreach ($c in $Connection) { $connections += Get-AMConnection -Connection $c } } } } return $connections } } |