psPAS 5.2.52 Release

[pspete]

Description

• Breaking Changes
  • Request-PASJustInTimeAccess
  • Command renamed from Request-PASAdHocAccess in line with CyberArk feature nomenclature.
  • Get-PASSafeMember
  • Adds capability to get permissions for individual safe member using the Gen2 API from 12.2 onward.
  • Addition of UseGen1API parameter allows operation against Gen1 API if required.
  • Set-PASSafeMember
  • Adds Gen2 API capability introduced in 12.2.
  • Default operation is now via Gen2 API.
  • Addition of UseGen1API parameter allows operation against Gen1 API if required.
  • Remove-PASSafeMember
  • Adds support for operation against Gen2 API introduced in PAS 12.2
  • Default operation now requires 12.2
  • UseGen1API parameter added to force operation against Gen1 API for earlier PAS versions.
  • Set-PASSafe
  • Adds Gen2 API capability introduced in 12.2.
  • Default operation is now via Gen2 API.
  • Addition of UseGen1API parameter allows operation against Gen1 API if required.
• New Commands
  • Get-PASAccountDetail
  • New experimental function developed using unofficial documentation
  • Revoke-PASJustInTimeAccess
  • New API function supported from 12.0 (previously missed)
  • Revokes requested JIT access.
  • Clear-PASLinkedAccount
  • Unlinks associated Logon/Reconcile/ExtraPass accounts
  • Get-PASPlatformSummary
  • Returns basic platform system type information
• Other Updates
  • Get-PASSafe
  • Implements Get Individual Safe details using Gen2 API feature of PAS 12.2.
  • Adds UseGen1API parameter to allow backward compatibility when using the SafeName parameter.
  • Changes depreciation of Gen1 API operations from 12.2 to 12.3.
  • Get-PASUser
  • New sort parameter added, supported from 12.2.
  • Added ability to filter by UserName using Gen2 API.
  • Gen1 search by UserName now accessible by also specifying the introduced UseGen1API parameter.
  • Get-PASGroup
  • New sort parameter added, supported from 12.2.
  • Add-PASGroupMember
  • Added version check to prevent use of Gen1 API starting from 12.3 in line with documented plan for API depreciation
  • New-PASUser
  • Added version check to prevent use of Gen1 API starting from 12.3 in line with documented plan for API depreciation
  • Remove-PASUser
  • Added version check to prevent use of Gen1 API starting from 12.3 in line with documented plan for API depreciation
  • Set-PASUser
  • Added version check to prevent use of Gen1 API starting from 12.3 in line with documented plan for API depreciation
  • Unblock-PASUser
  • Added version check to prevent use of Gen1 API starting from 12.3 in line with documented plan for API depreciation
  • Account Methods updated to apply to account details obtained via Gen2 API calls
  • VerifyPassword()
    • Updated method to use Invoke-PASCPMOperation
  • ChangePassword()
    • Updated method to use Invoke-PASCPMOperation
  • ReconcilePassword()
    • New method using Invoke-PASCPMOperation
  • GetDetails()
    • New method using Get-PASAccountDetail
  • Alias Removal
  • Removed alias values for previously depreciated command names

Fixes #

Type of change

• [X] Bug fix (non-breaking change which fixes an issue)
• [X] New feature (non-breaking change which adds functionality)
• [X] Breaking change (fix or feature that makes existing functionality work differently)
• [X] Documentation update (psPAS website or command help content)
• [X] Other (see description)

How Has This Been Tested?

• [ ] Pester test(s) update required
• [X] Pester test(s) updated
• [X] Pester test(s) passing

Test Configuration:

• PowerShell version: 5 & 7
• CyberArk PAS version: 12.2
• OS Version: Win 10

Checklist:

• [X] My code follows the style guidelines of this project
• [X] I have followed the contributing guidelines.
• [X] I have commented my code, particularly in hard-to-understand areas
• [X] I have made corresponding changes to the documentation
• [X] My changes generate no new test failures or errors
• [X] I have added tests that prove my fix is effective or that my feature works
• [X] New and existing unit tests pass locally with my changes
• [ ] I have opened & linked a related issue
• [ ] I have linked a related issue