AutomateAPI/Public/Connect-ControlSession.ps1 at master · ryan99fl/AutomateAPI · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
function Connect-ControlSession {
    <#
    .SYNOPSIS
        Will open a ConnectWise Control Remote Support session against a given machine.
    .DESCRIPTION
        Will open a ConnectWise Control Remote Support session against a given machine.

    .PARAMETER ComputerName
        The Automate computer name to connect to
    .PARAMETER ComputerID
        The Automate ComputerID to connect to
    .PARAMETER ID
        Taken from the Pipeline, IE Get-AutomateComputer -ComputerID 5 | Connect-ControlSession
    .PARAMETER ComputerObjects
        Used for Pipeline input from Get-AutomateComputer
    .OUTPUTS
        None (opens a Connect Control Remote Support session URL, via a URL to the default browser)
    .NOTES
        Version:        1.0
        Author:         Jason Rush
        Creation Date:  2019-10-15
        Purpose/Change: Initial script development

        Version:        1.1.0
        Author:         Darren White
        Creation Date:  2020-12-08
        Purpose/Change: Support connection to specified sessionid

    .EXAMPLE
        Connect-ControlSession -ComputerName TestComputer
    .EXAMPLE
        Connect-ControlSession -ComputerId 123
    .EXAMPLE
        Get-AutomateComputer -ComputerID 5 | Connect-ControlSession
    #>
    [CmdletBinding(DefaultParameterSetName = 'Name')]
    param
    (
        [Parameter(ParameterSetName = 'Name', Mandatory = $true, Position = 0, ValueFromPipeline = $true, ValueFromPipelineByPropertyName=$False)]
        [string[]]$ComputerName,

        [Parameter(ParameterSetName = 'ID', Mandatory = $true, Position = 0, ValueFromPipeline = $true, ValueFromPipelineByPropertyName=$False)]
        [int32[]]$ComputerID,

        [Parameter(ParameterSetName = 'pipeline', ValueFromPipelineByPropertyName=$true, Mandatory = $True)]
        [int32[]]$ID,

        [Parameter(ParameterSetName = 'sessionid', Mandatory=$False,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$False)]
        [guid[]]$SessionID,

        [Parameter(ParameterSetName = 'sessionid', Mandatory=$False,ValueFromPipeline=$False,ValueFromPipelineByPropertyName=$False)]
        [string]$ConnectAs = ($Script:ControlAPICredentials.Username),

        [Parameter(ParameterSetName = 'pipeline', ValueFromPipeline = $true, Mandatory = $True)]
        $ComputerObjects

    )

    Process {
        #If not pipeline mode, build ComputerObjects
        If ( !($PSCmdlet.ParameterSetName -eq 'pipeline') ) {
            $ComputerObjects = @()
        }

        If ($PSCmdlet.ParameterSetName -eq 'ID') {
            ForEach ($ComputerIDSingle in $ComputerID) {
                $ComputerObjects += (Get-AutomateComputer -ComputerID $ComputerIDSingle)
            }
        } ElseIf ($PSCmdlet.ParameterSetName -eq 'Name') {
            ForEach ($ComputerNameSingle in $ComputerName) {
                $ComputerObjects += (Get-AutomateComputer -ComputerName $ComputerNameSingle)
            }
        }

        If ($PSCmdlet.ParameterSetName -eq 'SessionID') {
            If (!$ConnectAs) {$ConnectAs=$Script:CWACredentials.Username}
            If (!$ConnectAs) {$ConnectAs="AutomateAPI"}
            #Process SessionID
            ForEach ($Session in $SessionID) {
                #Get Access Token. 149249 = Join(1) + RunSharedTool(256) + TransferFiles(512) + HostWithoutConsent(1024) + Print(16384) + ManageCredentials(131072)
                $Body=ConvertTo-Json @("$($Session)", $ConnectAs, 149249) -Compress
                $RESTRequest = @{
                    'URI' = "Service.ashx/GetHostAccessTokenForSessionId"
                    'Body' = $Body
                }
                $AccessToken = Invoke-ControlAPIMaster -Arguments $RESTRequest
                If ($AccessToken) {
                    Write-Debug "Access Token $($AccessToken) retrieved"
                    #Build Launch URL
                    $LaunchURL="$($Script:ControlServer)/App_Extensions/${Script:CWCExtensionID}/Launch.aspx?SessionID=$($Session)&HostAccessToken=$($AccessToken)"
                    Write-Debug "Starting $($LaunchURL)"
                    Start-Process "$($LaunchURL)"
                } Else {Write-Error "No Access Token was returned"}
            }
        } Else {
            ForEach ($Computer in $ComputerObjects) {
                try {
                    $(Get-AutomateControlInfo $Computer.ID).LaunchSession()
                }
                catch {}
            } #End ForEach
        }
    } #End Process

} #End Connect-ControlSession