Files
developer.sailpoint.com/docs/tools/sdk/powershell/getting-started.md
2024-02-28 10:26:45 -05:00

5.7 KiB

id, title, pagination_label, sidebar_label, sidebar_position, sidebar_class_name, keywords, description, slug, tags
id title pagination_label sidebar_label sidebar_position sidebar_class_name keywords description slug tags
powershell-sdk-getting-started Getting started with the PowerShell SDK PowerShell SDK Getting Started 1 powershellsdk
powershell
sdk
start
Learn how to use the PowerShell SDK in this guide. /tools/sdk/powershell/getting-started
SDK

Once your SDK is installed and configured, you can start accessing the SDK's different functionalities. To learn how to install and configure the PowerShell SDK, refer to Installation and Configuration.

To get an idea of what cmdlets the SDK offers run the following command. This command lists all available Get cmdlets within the SDK:

Get-Command -Module PSSailpoint | where-object {$_.name -like "*Get-*" } | Sort-Object Name | Get-Help | Format-Table Name, Synopsis

The SDK returns this output:

Name                             Synopsis
----                             --------
Get-AccessProfile                Get an Access Profile
Get-AccessProfileEntitlements    List Access Profile's Entitlements
Get-AccessProfiles               List Access Profiles
Get-AccessRequestApprovalSummary Get the number of access-requests-approvals
Get-AccessRequestConfig          Get Access Request Configuration
Get-AccessRequestStatus          Access Request Status
Get-Account                      Account Details
Get-AccountActivities            List Account Activities
Get-AccountActivity              Get an Account Activity
Get-AccountEntitlements          Account Entitlements
Get-Accounts                     Accounts List
Get-AccountsSchema               Downloads source accounts schema template
Get-ActiveCampaigns              List Campaigns
...

List Transforms

Let's say that you wanted to see all the transforms available in your tenant. You can search for the cmdlet:

Get-Command -Module PSSailpoint | where-object {$_.name -like "Get-*Transform*" } | Sort-Object Name | Get-Help | Format-Table Name, Synopsis

The SDK returns this output (all beta endpoints are designated by the Beta prefix):

Name               Synopsis
----               --------
Get-BetaTransform  Transform by ID
Get-BetaTransforms List transforms
Get-Transform      Transform by ID
Get-Transforms     List transforms

To get syntax, description and parameters for a single cmdlet, run this command:

Get-Help Get-Transforms -Detailed
Cmdlet Response
NAME
    Get-Transforms
    
SYNOPSIS
    List transforms
    
    
SYNTAX
    Get-Transforms [[-Offset] <Nullable`1>] [[-Limit] <Nullable`1>] [[-Count] <Nullable`1>] [[-Name] <String>] [[-Filters] <String>] [-WithHttpInfo] [<CommonParameters>]
    
    
DESCRIPTION
    Gets a list of all saved transform objects. A token with 'transforms-list read' authority is required to call this API.
    

PARAMETERS
    -Offset <Nullable`1>
        Offset into the full result set. Usually specified with *limit* to paginate through the results. For more information, refer to [V3 API Standard Collection 
        Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters).
        
    -Limit <Nullable`1>
        Max number of results to return. For more information, refer to [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters).
        
    -Count <Nullable`1>
        If *true* it will populate the *X-Total-Count* response header with the number of results that would be returned if *limit* and *offset* were ignored.  Since requesting a total count can have a 
        performance impact, it is recommended not to send **count=true** if that value will not be used. For more information, refer to [V3 API Standard Collection 
        Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters).
        
    -Name <String>
        Name of the transform to retrieve from the list.
        
    -Filters <String>
        Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results). Filtering is 
        supported for the following fields and operators:  **internal**: *eq*  **name**: *eq, sw*
        
    -WithHttpInfo [<SwitchParameter>]
        A switch that, when enabled, will return a hash table of Response, StatusCode and Headers, instead of just the Response.
        
    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, refer to
        about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Running Get-Transforms will return a list of all transforms in your tenant.

Running Get-Transforms -Limit 10 -Filter 'name sw Test"' will return a list of no more than 10 transforms whose names start with Test.

WithHttpInfo Switch

By default, the cmdlets return just the response from the API without including any information about status code or headers returned. Use the -WithHttpInfo switch to return this information with the response.

Get-Transforms -WithHttpInfo

Name                           Value
----                           -----
Headers                        {[Date, System.String[]], [Transfer-Encoding, System.String[]], [Connection, System.String[]], [Server, System.String[]]}
StatusCode                     200
Response                       {System.Management.Automation.OrderedHashtable, System.Management.Automation.OrderedHashtable, System.Management.Automation.Ordered