GET ACCOUNT REQUEST DETAILS

USE THIS FUNCTION TO GET THE DETAILS OF AN EXISTING ACCOUNT REQUEST

Get-VPASAccountRequestDetails [-RequestedSafe <String>] [-RequestedPlatform <String>] [-RequestedUsername <String>] [-RequestedAddress <String>] [-RequestedReason <String>] [-token <Hashtable>] [<CommonParameters>]

Get-VPASAccountRequestDetails -RequestedAcctID <String> [-RequestedReason <String>] [-token <Hashtable>] [<CommonParameters>]

Get-VPASAccountRequestDetails -requestID <String> [-token <Hashtable>] [<CommonParameters>]

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

-RequestedSafe <String>
Safe name that will be used to query for the target account if no AcctID is passed

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

-RequestedPlatform <String>
PlatformID that will be used to query for the target account if no AcctID is passed

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

-RequestedUsername <String>
Username that will be used to query for the target account if no AcctID is passed

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

-RequestedAddress <String>
Address that will be used to query for the target account if no AcctID is passed

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

-RequestedAcctID <String>
Unique ID that maps to a single account, passing this variable will skip query functions to find target account

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

-RequestedReason <String>
Reason that will be used to query and find the target account request

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

-requestID <String>
Unique ID that maps to a single account request, passing this variable will skip any query functions

Required: true
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)

$AccountRequestDetailsJSON = Get-VPASAccountRequestDetails -RequestedUsername {USERNAME VALUE} -RequestedReason {REASON VALUE}

$AccountRequestDetailsJSON = Get-VPASAccountRequestDetails -requestID {REQUESTID VALUE}

$InputParameters = @{
        RequestedSafe = "TargetSafe"
        RequestedPlatform = "TargetPlatformID"
        RequestedUsername = "TargetUsername"
         RequestedAddress = "TargetAddress"
         RequestedReason = "account needed to function"
}
$AccountRequestDetailsJSON = Get-VPASAccountRequestDetails -InputParameters $InputParameters

$InputParameters = @{
        RequestedAcctID = "22_123"
         RequestedReason = "account needed to function"
}
$AccountRequestDetailsJSON = Get-VPASAccountRequestDetails -InputParameters $InputParameters

$InputParameters = @{
        requestID = "TargetSafe_20"
}
$AccountRequestDetailsJSON = Get-VPASAccountRequestDetails -InputParameters $InputParameters

If successful:
{
         "VPASRequestSafe_20": {
                 "RequestID": "VPASRequestSafe_20",
                 "SafeName": "VPASRequestSafe",
                 "RequestorUserName": "vadim@vman.com",
                 "RequestorReason": "(ConnectionClient=PSM-RDP) Testing Account Request",
                 "UserReason": "Testing Account Request",
                 "CreationDate": 1724125545,
                 "Operation": "Connect to VPASDualControl-DomainAdmin011-vman.com",
                 "ExpirationDate": 1726717545,
                 "OperationType": 4,
                 "AccessType": "ManyTimes",
                 "ConfirmationsLeft": 1,
                 "AccessFrom": 1724158800,
                 "AccessTo": 1724173200,
                 "Status": 1,
                 "StatusTitle": "Waiting: 1 more user(s) must confirm the request",
                 "InvalidRequestReason": 0,
                 "CurrentConfirmationLevel": 1,
                 "RequiredConfirmersCountLevel2": 1,
                 "TicketingSystemProperties": {
                         "Name": null,
                         "Number": null,
                         "Status": null
                 },
                 "AdditionalInfo": {
                        
                 },
                 "AccountDetails": {
                         "AccountID": "120_3",
                 "Properties": "@{Address=vman.com; Safe=VPASRequestSafe; Folder=Root; Name=Operating System-VPASDualControl-vman.com-DomainAdmin01; PolicyID=VPASDualControl; PlatformName=VPASDualControl; DeviceType=Operating System; LastModifiedDate=1715222718000; LastModifiedBy=vadim@vman.com; LastUsedDate=1715222731000; LastUsedBy=vadim@vman.com; UserName=DomainAdmin011; LockedBy=; CPMDisabled=; CPMStatus=NoAction; ManagedByCPM=True; DeletedBy=; DeletionDate=0; ImmediateCPMTask=NoTask; LastCPMTask=NoTask; CreationDate=1715222718; IsSSHKey=False; IsIrregularPlatform=False; CreationMethod=PVWA}"
                 },
                 "Confirmers": [
                 "@{Type=1; ID=41; Name=vadim@vman.com; Action=2; Reason=; ActionDate=0; AdditionalDetails=; Members=}"
                 ]
         }
}

$false if failed