PowerShell Drive and Cmdlets for Orchestrator

Update-OrchMachine machine01 -RobotUsers robot01　で、テナントレベルでマッピングできることが分かりました。

Orchestratorの画面での下記操作に対応する、フォルダーを指定して、特定のアカウントとマシンのマッピングを実行する場合のコマンドレットの使い方を教えてください。

【Orchestrator画面での操作手順】

(1)左側フォルダ表示で対象フォルダ「Shared\folder01」を選択

(2)[設定]タブを表示して、[マシン]を表示

(3)マシン「machine01」の右端の[その他のアクション]メニューから[フォルダーのアカウントのマッピングを更新]を選択

(4)[このフォルダーに対して特定のアカウントとマシンのマッピングを指定]を選択

(5)アカウント「robot01」を選択して[更新]ボタンをクリック

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

【2024/12/2追記】

回答いただいた内容で、質問した通りの設定ができました。ありがとうございました。

下記①～④まで完了した状態で、ロボットのアカウント「robot01」をマシン「machine01」にマッピングするコマンドレットの使い方を教えてください。

①ロボットアカウント名の作成

Set-OrchPmRobotAccount -UserName robot01

②ロボットアカウントの定義

Add-OrchUser -UserName robot01 -Type DirectoryRobot -Roles 'Allow to be Automation User' -UR_UserName dm01\user01 -UR_Password pwd01

③フォルダーにマシン割り付け

Add-OrchFolderMachine -Path Shared\folder01 -Name machine01

④フォルダーにロボットアカウントを割り付け

Add-OrchFolderUser -Path Shared\folder01 -UserName robot01 -Type DirectoryRobot -Roles 'Automation User'

マシンテンプレート、ロボットアカウント、フォルダーを指定して無人オートメーションを作成したいときのコマンドレットを教えてください。(マシンテンプレート、ロボットアカウント、フォルダーは既に作成済です。)

Orchestratorの[テナント] - [マシン]タブにある[無人オートメーションの設定]をクリックして行う下記操作を、コマンドレットで行う方法についての質問です。

(1)インフラストラクチャーの構成を選択　→セルフホスト(Unattendedロボット)　→マシンテンプレート(静的)

(2)マシンテンプレートを作成または選択　→「machine01」を選択

(3)Unattendedロボットのアカウントを作成または選択　→「robot01」を選択

(4)フォルダーを選択　→「folder01」、「folder02」を選択

Automation Cloud環境へのエンティティを設定するときに、コマンドレットでどのようにパラメーターを指定すべきなのか知りたいので、問い合せする次第です。

（1）ロボットアカウント作成

下記操作によりロボットアカウント作成ができましたが、コマンドレット「Set-OrchPmRobotAccount」のパラメーターの補完機能で「-UserName」は表示しませんでした。このやり方で合っているでしょうか？

【操作例】

Set-OrchPmRobotAccount -UserName robot01

（2）ロールをロボットアカウントに割り付け

上記（1）で作成したrobot01に、ロール「Allow to be AutomationUser」、ドメイン\ユーザー名「dm01\user01」、 パスワード「pwd01」を割り付けたい場合に使用するコマンドレットを教えてください。

（3）無人オートメーションの設定

マシンテンプレート、ロボットアカウント、フォルダーを指定して無人オートメーションを作成したいときのコマンドレットを教えてください。

Yoshifumi Tsuda

>この症状の原因には、設定ファイル UiPathOrchConfig.json に指定するスコープが不足していることが考えられます。

>このツールの機密アプリの設定においては、最低限、OR.Folders.Read OR.Settings.Read が必要となります。

>また非機密アプリの設定においては、上記に加えて OR.Users.Read も必要です。

スレッド返信できないのですね。

UiPathOrchConfig.json　へ今回不足していた「OR.Settings.Read 」を追加　＆　機密アプリにスコープ追加したところ、問題は解決いたしました。

機密アプリ(Conf App)でアクセスすると、以下の様な動作になります。

　・初回NGで2回目はOK ( dir 'test:')

　・初回NGを出した後に Clear-OrchCache しないと2回目以降も失敗する (Get-OrchUser -Path test:)

非機密アプリでは問題が発生しません。

機密アプリの動きは不具合なのでしょうか？

■環境

PowerShell 7.4.5

UiPathOrch 0.9.6.23

Automation Cloud(Community)

■Example 1

PowerShell 7.4.5

PS C:> Import-Module UiPathOrch

PS C:> dir test:

Get-ChildItem: "test:": You are not authorized!

PS C:> dir test:

Directory: test:\

 Id DisplayName Description FolderType FeedType  ProvisionType

 -- ----------- ----------- ---------- --------  -------------

xxxxxxxx Shared Standard Processes Automatic

xxxxxxxx UR Standard Processes Automatic

PS C:>

■Example 2

PowerShell 7.4.5

PS C:> Import-Module UiPathOrch

PS C:> Get-OrchUser -Path test: | Select-Object FullName,Type

Get-OrchUser: "test:": You are not authorized!

PS C:> Get-OrchUser -Path test: | Select-Object FullName,Type

Get-OrchUser: "test:": You are not authorized!

PS C:> Clear-OrchCache

PS C:> Get-OrchUser -Path test: | Select-Object FullName,Type

FullName Type

---

Administrators DirectoryGroup

Automation Developers DirectoryGroup

Automation Users DirectoryGroup

Citizen Developers DirectoryGroup

Everyone DirectoryGroup

fk DirectoryUser

intec DirectoryUser

てすとろぼ DirectoryRobot

PS C:>

Thank you so much for your reply Yoshi... I opened uipath tech support ticket Case #:02430583

Awesome helpful tool.. All is working fine other than we are having trouble trying to create per-user Credential assets when we use our CyberArk credential store vs Orchestrator Database.

example - ExportedCredentialAssets.csv

Path,Name,Description,CredentialStore,UserName,MachineName,CredentialUsername,CredentialPasswordNonProdOrch:\Modern\UAT_Environment_Startup,UAT_TestCred3,,UAT_CyberArk_Managed_Bots,migrated default_uip_rpa_bb_2_193,193_Template,,Operating System-GLICWindowsLinuxSRVAccountManaged-RiskLevel1-glic.com-rb1tst1

When we run:

PS NonProdOrch:\Modern\UAT_Environment_Startup> Import-Csv C:\Users\ctsurum\Desktop\ExportedCredentialAssets.csv | Set-OrchCredentialAsset

We get this error:

Set-OrchCredentialAsset: "NonProdOrch:\Modern\UAT_Environment_Startup\UAT_TestCred3": Password for credentials stored in CyberArkCCP is read-only.

Any idea what might be the issue?

Thanks in advance for any guidance and for providing this excellent tool