Skip to content

UiPath/orchestrator-powershell

Repository files navigation

UiPath Orchestrator PowerShell library

A PowerShell library for interacting with UiPath Orchestrator.

PS C:\>Install-PackageProvider -Name NuGet -Force
PS C:\>Register-PSRepository -Name UiPath -SourceLocation https://www.myget.org/F/uipath-dev/api/v2
PS C:\>Install-Module -Repository UiPath -Name UiPath.Powershell -Force
PS C:\>Import-Module UiPath.PowerShell

Login to UiPath Automation Cloud using interactive login

PS C:\>Get-UiPathAuthToken -Session

Login to UiPath Automation Cloud using API keys

PS C:\>Get-UiPathAuthToken -Session -ClientId <your_client_id> -UserKey <your_user_key>

#Login to your on-premise deployed Orchestrator

PS C:\>Get-UiPathAuthToken -Session -URL <orchestrator_url> -Username <username> -Password <password>

Using the UiPath.PowerShell module

The full documentation is in docs

Use the PowerShell Get-Command to obtain all cmdlets exported by the module:

PS C:\>Get-Command -Module UiPath.PowerShell

You can obtain each command syntax using PowerShell's own Get-Help:

PS C:\>Get-Help Add-UiPathRobot

To start using the library, you need to connect first to a running Orchestrator instance. Use the Get-UiPathAuthToken cmdlet:

PS C:\>Get-UiPathAuthToken -URL <orchestratorurl> -Username <OrchestratorUser> -Password <password> -Session

To connect to an Orchestrator instance using integrated AD and SSO, use the -WindowsCredentials argument to obtain the token. The library will authenticate to Orchestrator as the Windows user running the PowerShell session:

PS C:\>Get-UiPathAuthToken -URL <orchestratorurl> -WindowsCredentials -Session

The -Session flag makes the authentication persist on the PowerShell session for up to 30 minutes. After this you will not have to authenticate again each cmdlet. Some examples:

Use Get-UiPathAuthToken ... -TenantName <tenantName> for multi-tenant Orchetsrator deployments. Use Get-UiPathAuthToken ... -OrganizationUnit <OUName> for Orchetsrator deployments with OrganizationUnits enabled.

If you don't specify any argument, the authentication will be an interactive authentication with the UiPath Cloud service.

PS C:\> Get-UiPathRobot | Format-Table

 Id LicenseKey MachineName    Name           Description
 -- ---------- -----------    ----           -----------

132            RERUSANU       PwdRobot1
133            RERUSANU       PwdRobot2
134            RERUSANU       PwdRobot3

For more example, see the docs

Getting Started

Automated install

Register the UiPath Gallery as a NuGet module provider

The UiPath.PowerShell module can be installed as a NuGet package. You will need to run once these commands first:

PS C:\>Install-PackageProvider -Name NuGet -Force -Scope CurrentUser
PS C:\>Register-PSRepository -Name UiPath -SourceLocation https://www.myget.org/F/uipath-dev/api/v2

Note that in the example above the use of -Scope CurrentUser means that the NuGet package provider is registered only for the current user. This does not require administrative privilegs, but the registration is transient. You may opt instead to run from an elevated prompt and remove the -Scope CurrentUser for a permanent registration.

You can validate that the NuGet package provider and the UiPath Gallery repository are registered:

PS C:\>Get-PackageProvider -Name NuGet

Name                     Version          DynamicOptions
----                     -------          --------------
NuGet                    2.8.5.208        Destination, ExcludeVersion, Scope, SkipDependencies, Headers, FilterOnTag...

PS C:>Get-PSRepository

Name                      InstallationPolicy   SourceLocation
----                      ------------------   --------------
PSGallery                 Untrusted            https://www.powershellgallery.com/api/v2
UiPath                    Untrusted            https://www.myget.org/F/uipath-dev/api/v2

Install the UiPath.PowerShell module using the UiPath repository

PS C:\>Install-Module -Repository UiPath -Name UiPath.Powershell -Force  -Scope CurrentUser
PS C:\>Import-Module UiPath.PowerShell

This command will download, install and import the UiPath.PowerShell module. Again, you can opt to use a global scope by removing the -Scope CurrentUser argument, but this will require running the command an elevated prompt.

You can validate that the module was downloaded, installed and loaded:

PS c:\>Get-Module UiPath.PowerShell

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     18.3.2.... UiPath.PowerShell                   {Add-UiPathAsset, Add-UiPathEnvironment, Add-UiPathEnviron...

Manual Install

Download the package from https://www.myget.org/feed/uipath-dev/package/nuget/UiPath.PowerShell, extract the content, and then run:

PS c:\>Import-Module UiPath.PowerShell.dll

License

This project is copyright UiPath INC and licensed under the MIT License - see the LICENSE.md file for details.

Prerequisites for building from source

To build the project, In addition to the C# SDK (the solution is Visual Studio 2017 based) you will need autorest. To use the library you won't need anything but the build artifacts.

About

UiPath Orchestrator PowerShell cmdlet library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published