GET PSM SESSION DETAILS

USE THIS FUNCTION TO GET PSM SESSION DETAILS

Get-VPASPSMSessionDetails -SearchQuery <String> [-ExportToCSV] [-CSVDirectory <String>] [-token <Hashtable>] [<CommonParameters>]

Get-VPASPSMSessionDetails -PSMSessionID <String> [-ExportToCSV] [-CSVDirectory <String>] [-token <Hashtable>] [<CommonParameters>]

Get-VPASPSMSessionDetails -InputParameters <Hashtable> [-token <Hashtable>] [<CommonParameters>]

-SearchQuery <String>
Search string to find target resource via username, address, safe, platform, etc.
Comma separated for multiple fields, or to search all pass a blank value like so: " "

Required: true
Position: named
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-PSMSessionID <String>
Unique ID that maps to the target PSMSession
Supply the PSMSessionID to skip any querying to find the target PSMSession

Required: true
Position: named
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-ExportToCSV [<SwitchParameter>]
Output results to a CSV file found in AppData\Local\VPASModuleOutputs directory

Required: false
Position: named
Default value: False
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-CSVDirectory <String>
Output directory where the exported CSV file will be saved to
Default value: C:\Users\{CurrentUser}\AppData\Local\VPASModuleOutputs\ExportedCSVs

Required: false
Position: named
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-InputParameters <Hashtable>
HashTable of values containing the parameters required to make the API call

Required: true
Position: named
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-token <Hashtable>
HashTable of data containing various pieces of login information (PVWA, LoginToken, HeaderType, etc).
If -token is not passed, function will use last known hashtable generated by New-VPASToken

Required: false
Position: named
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug
ErrorAction, ErrorVariable, WarningAction, WarningVariable
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216)

$GetPSMSessionDetailsJSON = Get-VPASPSMSessionDetails -SearchQuery {SEARCHQUERY VALUE}

$GetPSMSessionDetailsJSON = Get-VPASPSMSessionDetails -PSMSessionID {PSM SESSION ID VALUE}

$InputParameters = @{
        SearchQuery = "DomainAdmin01"
         ExportToCSV = $true|$false
         CSVDirectory = "C:\Temp"
}
$GetPSMSessionDetailsJSON = Get-VPASPSMSessionDetails -InputParameters $InputParameters

$InputParameters = @{
        PSMSessionID = "36_101"
         ExportToCSV = $true|$false
         CSVDirectory = "C:\Temp"
}
$GetPSMSessionDetailsJSON = Get-VPASPSMSessionDetails -InputParameters $InputParameters

If successful:
{
         "Recordings": [
                 {
                         "SessionID": "36_102",
                         "SessionGuid": "kjsad8972-jhgs-lkjw-8976-ksjdhfkj462",
                         "SafeName": "PSMRecordings",
                         "FolderName": "Root",
                         "IsLive": false,
                         "FileName": "kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.session",
                         "Start": 1712111269,
                         "End": 1712111328,
                         "Duration": 59,
                         "User": "vadim@vman.com",
                         "RemoteMachine": "192.168.111.111",
                         "ProtectionDate": 0,
                         "ProtectedBy": "",
                         "ProtectionEnabled": false,
                         "AccountUsername": "vmanda",
                         "AccountPlatformID": "VadimWindowsDomain",
                         "AccountAddress": "vman.com",
                         "PIMSuCommand": "",
                         "PIMSuCWD": "",
                         "ConnectionComponentID": "PSM-RDP",
                         "PSMRecordingEntity": "SessionRecording",
                         "TicketID": "",
                         "FromIP": "192.168.222.222",
                         "Protocol": "RDP",
                         "Client": "RDP",
                         "RiskScore": -1,
                         "Severity": "",
                         "IncidentDetails": null,
                 "RawProperties": "@{Address=vman.com; ConnectionComponentID=PSM-RDP; DeviceType=Operating System; EntityVersion=1.0; ExpectedRecordingsList=kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.WIN.txt,kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.VID.avi; PSMClientApp=mstsc.exe; PSMPasswordID=9; PSMProtocol=RDP; PSMRecordingEntity=SessionRecording; PSMRemoteMachine=192.168.111.111; PSMSafeID=68; PSMSourceAddress=192.168.222.222; PSMStartTime=1712111269; PSMStatus=Final; PSMVaultUserName=vadim@vman.com; PolicyID=VadimWindowsDomain; ProviderID=PSMApp_VmanCon01; UserName=vmanda; PSMEndTime=1712111328; ActualRecordings=kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.WIN.txt;187,kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.VID.avi;188; Safe=PSMRecordings; Folder=Root; Name=kjsad8972-jhgs-lkjw-8976-ksjdhfkj462.session}",
                         "RecordingFiles": " ",
                         "RecordedActivities": "",
                         "VideoSize": 1772412,
                         "TextSize": 3048,
                         "DetailsUrl": "recordingdetails.aspx?Data=lkjhf897346958734hr89u734nf05hf0753hf093njf089j4098fjn04398jf09834jf098j34098j309fj8fj3pf093h"
                 }
         ],
         "Total": 0
}

$false if failed