GET PASSWORD HISTORY

USE THIS FUNCTION TO GET HISTORY OF OLD PASSWORDS OF AN ACCOUNT IN CYBERARK

Get-VPASPasswordHistory [-safe <String>] [-platform <String>] [-username <String>] [-address <String>] [-ShowTemporary] [-token <Hashtable>] [<CommonParameters>]

Get-VPASPasswordHistory [-ShowTemporary] -AcctID <String> [-token <Hashtable>] [<CommonParameters>]

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

-safe <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

-platform <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

-username <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

-address <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

-ShowTemporary [<SwitchParameter>]
Specify if temporary passwords should be included in the history that is being pulled
Temporary passwords are passwords that the CPM attempted to set on the account but failed to do so

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

-AcctID <String>
Unique ID that maps to a single account, 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)

$AccountPasswordsHistoryJSON = Get-VPASPasswordHistory -ShowTemporary -safe {SAFE VALUE} -address {ADDRESS VALUE}

$InputParameters = @{
        safe = "TargetSafe"
        platform = "TargetPlatformID"
        username = "TargetUsername"
         address = "TargetAddress"
         ShowTemporary = $true|$false
}
$AccountPasswordsHistoryJSON = Get-VPASPasswordHistory -InputParameters $InputParameters

$InputParameters = @{
        AcctID = "25_13"
         ShowTemporary = $true|$false
}
$AccountPasswordsHistoryJSON = Get-VPASPasswordHistory -InputParameters $InputParameters

If successful:
{
         "Versions": [
                 {
                         "versionID": 43,
                         "modifiedBy": "vadim@vman.com",
                         "modificationDate": 1721098334,
                         "isTemporary": false
                 },
                 {
                         "versionID": 44,
                         "modifiedBy": "vadim@vman.com",
                         "modificationDate": 1721098984,
                         "isTemporary": false
                 }
         ],
         "Total": 2
}

$false if failed