Release 1.1.6 SailPoint IdentityNow PowerShell Module

I’ve just published v1.1.6 of the SailPoint IdentityNow PowerShell Module to both GitHub and the PowerShell Gallery. Release 1.1.6 of the SailPoint IdentityNow PowerShell Module is the result of updates by Sean McGovern, Yannick Beot, David Minnelli and myself.

This a community module and I’d love to have others submit updates. Especially for both new IdentityNow features and updates to cmdlets from private APIs to v3.

Release 1.1.6’s updates comprise changes to cmdlets to account for changes to utilise only a Personal Access Token (PAT), four new cmdlets, cmdlet updates for API changes, bug-fixes and documentation updates.

Version 1.1.5 to Version 1.1.6 Release Notes

Personal Access Token is the preferred default method for API authentication moving forward. SailPoint Compass Reference. This version fixes a console output error if only a PAT was present in your credential configuration.

New cmdlets in v1.1.6

The following four cmdlets are new in v1.1.6.

  • Get-IdentityNowAggregationStatus
    • Get the status of an IdentityNow Aggregation
  • Invoke-IdentityNowRoleRefresh
    • Refresh all IdentityNow Roles, or an individual IdentityNow Role
  • Get-IdentityNowManagedCluster
    • A Beta cmdlet to use the new IdentityNowManagedCluster API to get Virtual Appliance Cluster information
  • Invoke-IdentityNowAggregateEntitlement
    • Initiate Entitlement Aggregation of an IdentityNow Source

v1.1.6 Updated cmdlets for v3 APIs

The following three cmdlets are the first to be updated from private APIs to v3 APIs.

As the historical cmdlets are still (currently) functional on the private APIs and to make updating easy, the previous version cmdlets have been updated to include a V3API option switch. If the -V3API switch is omitted the cmdlet functions as it previously did using the associated cmdlets’ private API. Using the -V3API option switch will instruct the cmdlet to use the associated v3 API.

Using the V3API switch with Update-IdentityNowRole actually uses the Beta V3 API for Roles.

New cmdlet examples

  • Update-IdentityNowRole
    • Private API example
      • Update-IdentityNowRole -update “{“id”: “2c9180886cd58059016d1a4757d709a4”, “description”: “Special Administrators Role”,”name”: “Role – Special Administrators”,”owner”: “darren.robinson”,”displayName”: “Special Administrators”,”disabled”: false}”
    • V3API example
      • Update-IdentityNowRole -V3API -id 2c9180886cd58059016d1a4757d709a4 -update ‘[{“op”: “replace”,”path”: “/requestable”,”value”: true}]’
  • Get-IdentityNowSource
    • Private API example
      • Get-IdentityNowSource -sourceID 12345
    • V3API example
      • Get-IdentityNowSource -V3API -sourceID 2c9180878222e82901822f395b5528c8
  • Update-IdentityNowSource
    • Private API example
      • Update-IdentityNowSource -sourceid 123456 -update ‘connector_oauth_request_parameters={“scope”:”users:read,users:write”}’
    • V3API Example
      • Update-IdentityNowSource -V3API -sourceID 2c9180878222e82901822f395b5528c8 -update ‘[{“op”: “replace”,”path”: “/description”,”value”: “new description”}]’

Full List of Release 1.1.6 cmdlets

Complete-IdentityNowTask
Convert-UnixTime
Export-IdentityNowConfig
Get-HashString
Get-IdentityNowAccessProfile
Get-IdentityNowAccountActivities
Get-IdentityNowAccountActivity
Get-IdentityNowActiveJobs
Get-IdentityNowAggregationStatus
Get-IdentityNowAPIClient
Get-IdentityNowApplication
Get-IdentityNowApplicationAccessProfile
Get-IdentityNowAuth
Get-IdentityNowCertCampaign
Get-IdentityNowCertCampaignReport
Get-IdentityNowEmailTemplate
Get-IdentityNowGovernanceGroup
Get-IdentityNowIdentityAttribute
Get-IdentityNowIdentityAttributePreview
Get-IdentityNowManagedCluster
Get-IdentityNowOAuthAPIClient
Get-IdentityNowOrg
Get-IdentityNowOrgConfig
Get-IdentityNowOrgStatus
Get-IdentityNowPersonalAccessToken
Get-IdentityNowProfile
Get-IdentityNowProfileOrder
Get-IdentityNowQueue
Get-IdentityNowRole
Get-IdentityNowRule
Get-IdentityNowSource
Get-IdentityNowSourceAccounts
Get-IdentityNowSourceSchema
Get-IdentityNowTask
Get-IdentityNowTimeZone
Get-IdentityNowTransform
Get-IdentityNowVACluster
Invoke-IdentityNowAccountCorrelation
Invoke-IdentityNowAggregateEntitlement
Invoke-IdentityNowAggregateSource
Invoke-IdentityNowRequest
Invoke-IdentityNowRoleRefresh
Invoke-IdentityNowSourceReset
Join-IdentityNowAccount
New-IdentityNowAccessProfile
New-IdentityNowAPIClient
New-IdentityNowCertCampaign
New-IdentityNowGovernanceGroup
New-IdentityNowIdentityProfilesReport
New-IdentityNowOAuthAPIClient
New-IdentityNowPersonalAccessToken
New-IdentityNowProfile
New-IdentityNowRole
New-IdentityNowSource
New-IdentityNowSourceAccountSchemaAttr
New-IdentityNowSourceConfigReport
New-IdentityNowSourceEntitlements
New-IdentityNowTransform
New-IdentityNowUserSourceAccount
Remove-IdentityNowAccessProfile
Remove-IdentityNowAPIClient
Remove-IdentityNowGovernanceGroup
Remove-IdentityNowOAuthAPIClient
Remove-IdentityNowPersonalAccessToken
Remove-IdentityNowProfile
Remove-IdentityNowRole
Remove-IdentityNowSource
Remove-IdentityNowTransform
Remove-IdentityNowUserSourceAccount
Save-IdentityNowConfiguration
Search-IdentityNow
Search-IdentityNowEntitlements
Search-IdentityNowEvents
Search-IdentityNowIdentities
Search-IdentityNowUserProfile
Search-IdentityNowUsers
Set-IdentityNowCredential
Set-IdentityNowOrg
Set-IdentityNowTimeZone
Set-IdentityNowTransformLookup
Start-IdentityNowCertCampaign
Start-IdentityNowProfileUserRefresh
Test-IdentityNowCredentials
Test-IdentityNowSourceConnection
Test-IdentityNowToken
Test-IdentityNowTransforms
Update-IdentityNowAccessProfile
Update-IdentityNowApplication
Update-IdentityNowEmailTemplate
Update-IdentityNowGovernanceGroup
Update-IdentityNowIdentityAttribute
Update-IdentityNowOrgConfig
Update-IdentityNowProfileMapping
Update-IdentityNowProfileOrder
Update-IdentityNowRole
Update-IdentityNowSource
Update-IdentityNowTransform
Update-IdentityNowUserSourceAccount

Please contribute

Found an issue? Log it here and we’ll take a look at it. Want to fix an issue yourself or add functionality? That would be awesome. Fork the project, make your changes or additions and test. Update the Readme.md and submit a pull request.