Devolutions.Server

2021.6.0

Private/Entries/Get-DSEntryLegacy.ps1

function Get-DSEntryLegacy{
    <#
    .SYNOPSIS
     
    .DESCRIPTION
     
    .EXAMPLE
     
    .NOTES
     
    .LINK
    #>
        [CmdletBinding()]
        [OutputType([ServerResponse])]
        param(            
            [ValidateNotNullOrEmpty()]
            [GUID]$EntryId,
            [switch]$IncludeAdvancedProperties            
        )
        
        BEGIN {
            Write-Verbose '[Get-DSEntryLegacy] Beginning...'

            if ([string]::IsNullOrWhiteSpace($Global:DSSessionToken))
            {
                throw "Session does not seem authenticated, call New-DSSession."
            }
        }
    
        PROCESS {
            if ($IncludeAdvancedProperties.IsPresent)
            {
                $URI = "$Script:DSBaseURI/api/Connections/partial/$($EntryId)/resolved-variables"
            } else {
                $URI = "$Script:DSBaseURI/api/Connections/partial/$($EntryId)"
            }
            $PSBoundParameters.Remove('IncludeAdvancedProperties') | out-null
            try
            {   
                $params = @{
                    Uri = $URI
                    Method = 'GET'
                    LegacyResponse = $true
                }

                Write-Verbose "[Get-DSEntryLegacy] about to call $Uri"

                [ServerResponse] $response = Invoke-DS @params

                if ($response.isSuccess)
                { 
                    Write-Verbose "[Get-DSEntryLegacy] Got $($response.Body.Length)"
                }
                
                If ([System.Management.Automation.ActionPreference]::SilentlyContinue -ne $DebugPreference) {
                        Write-Debug "[Response.Body] $($response.Body)"
                }

                return $response
            }
            catch
            {
                $exc = $_.Exception
                If ([System.Management.Automation.ActionPreference]::SilentlyContinue -ne $DebugPreference) {
                        Write-Debug "[Exception] $exc"
                } 
            }
        }
    
        END {
           If ($?) {
                Write-Verbose '[Get-DSEntryLegacy] Completed Successfully.'
            } else {
                Write-Verbose '[Get-DSEntryLegacy] ended with errors...'
            }
        }
    }