Devolutions.Server

2021.6.0

Public/Vaults/Set-DSVaultsContext.ps1

function Set-DSVaultsContext {
    <#
    .SYNOPSIS
    The Legacy API still has a "current" Vault in context.
    .DESCRIPTION
     
    .EXAMPLE
     
    .NOTES
     
    .LINK
    #>
    [CmdletBinding()]
    [OutputType([ServerResponse])]
    param(            
        [Parameter(Mandatory)]
        [string]$vaultId
    )
        
    BEGIN {
        Write-Verbose '[Set-DSVaultsContext] Beginning...'
    
        $URI = "$Script:DSBaseURI/api/security/vaults/change"

        if ([string]::IsNullOrWhiteSpace($Global:DSSessionToken)) {
            throw "Session does not seem authenticated, call New-DSSession."
        }
    }
    
    PROCESS {
        try {       
            $params = @{
                Uri    = $URI
                Method = 'PUT'
                Body   = """$vaultId"""
            }

            Write-Verbose "[Set-DSVaultsContext] about to call with $($params.Uri)"

            $response = Invoke-DS @params
                
            If ([System.Management.Automation.ActionPreference]::SilentlyContinue -ne $DebugPreference) {
                Write-Debug "[Response.Body] $($response.Body)"
            }

            return $response
        }
        catch {
            $exc = $_.Exception
            Write-Verbose '[Set-DSVaultsContext] Exception occurred ...'
            If ([System.Management.Automation.ActionPreference]::SilentlyContinue -ne $DebugPreference) {
                Write-Debug "[Exception] $exc"
            } 
        }
    }
    
    END {
        if ($? -and $response.isSuccess) {
            Write-Verbose "[Set-DSVaultsContext] Ended successfully!"
        }
        else {
            Write-Verbose "[Set-DSVaultsContext] Ended with error..."
        }
    }
}