コマンド ライン パラメーター

Studio および Robot のインストールおよび更新を行ったり、コマンド ラインから UiPathStudio.msi インストーラーまたは UiPathStudioCloud.msi インストーラーを実行して既存のインストールを変更できます。

以下のセクションに、使用できるパラメーターの説明およびいくつかの使用例を示します。

注:

• これらのコマンドを実行するには、管理者権限が必要です。
• インストーラーをコマンド ラインからサイレント モードで実行して、既存のインストールを変更することはできません。ただし、インストーラーをサイレント モードで実行して、旧バージョンから更新することはできます。
• msiexec.exe の /passive オプションを使用した無人モードのインストールの実行はサポートされていません。

コマンド ライン引数の説明

以下の表に、使用できるすべてのコマンド ライン パラメーターのリストを示します。

クリーン インストールにはすべてのパラメーターを使用できますが、旧バージョンからの更新または既存のインストールの変更の場合は、以下のパラメーターのみサポートされます。

• ADDLOCAL を使用して機能を有効化します。
• REMOVE を使用して機能を無効化します。Robot を無効化することはできませんので注意してください。
• SERVICE_URL - RegisterService 引数を含めずに Robot をサービス モードからユーザー モードに切り替える場合に使用できます。
• NUGET_OPTIONS、ENFORCE_SIGNED_EXECUTION、DISABLE_SECURE_XAML、および TELEMETRY_ENABLED - 古いバージョンからの更新で利用できます。既存のインストールを変更する場合は利用できません。

パスを入力する際は、以下の点を考慮するようにしてください。

• %USERNAME% や %USERPROFILE% などの環境変数を使用する必要がある場合は、特殊文字 % は、次のようにエスケープする必要があります。
  • セットアップをコマンド プロンプトから呼び出した場合 - ^ - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^% を使用します。
  • バッチ スクリプトの場合 - ^ - UiPathStudio.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^% を使用します。
  • PowerShell コンソールまたはスクリプト - エスケーブは不要です。
  • Active Directory ドメイン アカウントを使用している場合は、フォルダー構造にもドメイン名を指定することを推奨します。例: C:\packages\^%UserDomain^%.^%Username^%
• 空白が含まれるパスを使用する必要がある場合は、次のようにパスをラップする必要があります。
  • コマンド プロンプトでは、二重引用符 (" ") で囲みます。例: UiPathStudio.msi APPLICATIONFOLDER="C:\folder name"
  • PowerShell では、一重引用符と二重引用符 ('" "') で囲みます。例: ./UiPathStudio.msi APPLICATIONFOLDER='"C:\folder name"'

コマンド	説明
/q	特定の UiPath 機能のサイレント モードでのインストールに対応していますが、ユーザー インターフェイスは表示されません。
/l*vx <LogFile>	インストーラーのログ ファイルを指定したパスに生成します。v2018.4.2 以降、Studio または Robot のライセンスをインストール時に取得した場合、このファイルにはライセンス情報も含まれます。 インストール プロセスの間に問題が発生した場合は、理由を問わず、UiPath のサポート チームにファイルを送信できます。
ADDLOCAL	インストールする機能を選択できます。ADDLOCAL を使用すると、このコマンドで指定した機能のみがインストールされます。ADDLOCAL を使用しないと、Studio、サービス モードの Robot、アクティビティ パッケージ、および JavaScript アドオンがインストールされます。 次のオプションがサポートされています。 Studio - Studio をインストールします。 ExcelAddin - StudioX Excel アドインをインストールします。同時に Studio の指定が必要です。 Robot - Robot をユーザー モードまたはサービス モードでインストールし、さらに Assistant もインストールします。 Robot をサービス モードでインストールするには、RegisterService オプションも追加します。これは Unattended ロボットに推奨されるオプションです。 Robot をユーザー モードでインストールするには、RegisterService オプションを追加しないでください。これは Attended ロボットおよび Development ロボットに推奨されるオプションです。 Robot をサービス モードからユーザー モードに変換すると、Robot が元の NuGet パッケージ フォルダーの .xaml ファイルにアクセスできなくなる場合があります。これを解決する方法について詳しくは、トラブルシューティング セクションの「 移行後に NuGet パッケージにアクセスできない 」をご覧ください。 Packages - アクティビティ パッケージをインストールします。同時に Robot 引数を指定する必要があります。 StartupLauncher - Windows の起動時に Robot を実行します。同時に Robot 引数を指定する必要があります。 JavaBridge - Java アプリケーションの連携と自動化を向上させるために UiPath Java Bridge をインストールします。Java Bridge をインストールする場合、インストールに通常より長い時間がかかる場合があります。同時に Robot 引数を指定する必要があります。 ChromeExtension - UiPath Google Chrome 拡張機能をインストールします。同時に Robot 引数を指定する必要があります。 FirefoxExtension - 例: UiPathStudio.msi ADDLOCAL=Studio,Robot,ChromeExtension,FirefoxExtension /Q EdgeExtension - UiPath Microsoft Edge (Chromium ベース) 拡張機能をインストールします。同時に Robot 引数を指定する必要があります。 CitrixClient - UiPath Citrix クライアント拡張機能をインストールします。同時に Robot 引数を指定する必要があります。 JavaScriptAddOn - Robot JavaScript SDK をサポートする Robot JavaScript アドオンをインストールします。 SapPlugin - SAP Solution Manager プラグインをインストールします。マシンに SAP Connector for Microsoft がインストールされている必要があります。クリーン インストールの場合は、SAP_SOL_MAN_HOST パラメーターを使用してインスタンスのアドレスを指定する必要もあります。同時に Studio の指定が必要です。 VMwareExtension - VMware Horizon 向けの UiPath 拡張機能をインストールします。同時に Robot 引数を指定する必要があります。 WindowsRdpExtension - Microsoft リモート デスクトップ向けの UiPath 拡張機能をインストールします。同時に Robot 引数を指定する必要があります。
MSIINSTALLPERUSER	このパラメーターを使用すると、Studio と Robot をユーザー単位またはマシン単位でインストールできます。 このパラメーターが含まれない場合、インストールはマシン単位で行われます。MSIINSTALLPERUSER=1 を追加すると、インストールはユーザー単位で行われます。 これらのパラメーターは、クリーン インストールを実行する場合にのみ使用できます。 ユーザー単位のインストールでは、RegisterService、CitrixExtension、VMwareExtension、SapPlugin、PACKAGES_FOLDER、CODE オプションは利用できません。
SAP_SOL_MAN_HOST	SAP Solution Manager インスタンスのホスト名または IP アドレス。ADDLOCAL オプションに SapPlugin 引数が指定されている場合のクリーン インストールに必要です。 例: UiPathStudio.msi ADDLOCAL=Studio,Robot,SapPlugin SAP_SOL_MAN_HOST=ip_address
APPLICATIONFOLDER	Studio と Robot を指定の場所にインストールできます。
NUGET_OPTIONS	オフライン環境で作業する場合には、このパラメーターが推奨されます。このパラメーターを DisableOnlineFeeds に設定すると、ロボット用のオンラインの UiPath 公式フィードやコミュニティ フィードを無効化できます。こうすることで、Orchestrator フィードとローカル フィールドのみが考慮されます。 URL フィードは設定ファイルから削除されず、単に無視されるだけです。 It can be used for both installations and upgrades. The NUGET_OPTIONS parameter does not disable the online UiPath official and Community feeds for Studio.
PACKAGES_FOLDER	Studio および/または Robot のワークフローとその依存関係のダウンロード場所を変更できます。このフォルダーは、ユーザー固有のフォルダー、またはマシンのすべてのユーザーがアクセスできるフォルダーです。このパラメーターは、サービス モードまたはユーザー モードのロボットの両方で使用できます。このパラメーターを入力しない場合、既定のフォルダーは %userProfile%\.nuget\packages になります。 パッケージ フォルダーを変更する場合、プロセスを実行する必要があるすべてのユーザーがこのフォルダーに対する読み取りアクセス権を持っていることを確認してください。 When using the PACKAGES_FOLDER parameter, there are some limitations. Find out more in the custom package folders and network paths documentation. For installations on Windows Server machines (that enable concurrent execution - HD Robots), you must provide paths that are specific to each user. Read more about using the same path for multiple robots. For information on how to change the download folder for packages after installation, see Managing Activities Packages.
CUSTOM_NUGET_FEEDS	Studio や Robot 用にカスタムの NuGet アクティビティ フィードを追加できます。このコマンドは、既存のフィード リストの追加または更新のみを行います。 文字列型のキーと値のペアを設定する必要があります。有効な場所には、オンライン フィード、フォルダー パス、共有ネットワーク ドライブが含まれます。指定するフィードは、そのマシンのすべてのユーザーがアクセス可能なものにしてください。フィードはセミコロン (;) で区切ります。 例: CUSTOM_NUGET_FEEDS="FeedName1,https://my.custom.nuget.feed; FeedName2,D:\Custom\Activities\Packages\"。
ENFORCE_SIGNED_EXECUTION	任意です。ロボットに署名付きパッケージのみを実行させるルールを適用できます。インスタンスのクリーン インストール時または更新時に使用できます。デプロイ時にこのパラメーターを指定しなかった場合、パッケージの署名は有効化されません。 次のオプションがサポートされています。 1 - The Robot is able to download, install, or execute only packages author or repository signed by UiPath. If you want to add your own certificate as a trusted source, you have to do so by modifying the nuget.config file. To learn how to do this, please see this page. 0 - ロボットのデプロイに、パッケージ署名に関するルールは一切適用されません。 For information on how to enforce signed execution after installation, see Signing Packages .
CODE	Studio インスタンスのライセンス コードを指定します。
CLIENT_SECRET および CLIENT_ID	インストール時に 、クライアント資格情報を使用して ロボットを Orchestrator に自動的に接続します。 例: UiPathStudio.msi ORCHESTRATOR_URL=https://demo.uipath.com/company/tenant/orchestrator_ CLIENT_ID=1234-abcd-1ab2-cd32-1111 CLIENT_SECRET=2143ndafj32k
CHROME_INSTALL_TYPE	Chrome 拡張機能のインストール方法を選択できます。このパラメーターを設定するには、管理者権限でインストーラーを実行する必要があります。省略した場合は、最も適切なインストール方法が自動的に選択されます。 次のオプションがサポートされています。 POLICYOFFLINE - The Chrome Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Chrome-Policy-Offline command using the SetupExtensions tool. POLICYONLINE - The Chrome Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /ChromePolicyGlobal command using the SetupExtensions tool. MANUALPERMACHINE - The Chrome Extension is installed for all users, the equivalent of calling the /ChromeGlobal command using the SetupExtensions tool. NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /ChromeNativeHostGlobal command using the SetupExtensions tool. 後方互換性を確保するため、古いインストール方法の名前 (STORE、GLOBAL) が維持されています。
EDGE_INSTALL_TYPE	Edge 拡張機能のインストール方法を選択できます。このパラメーターを設定するには、管理者権限でインストーラーを実行する必要があります。省略した場合は、最も適切なインストール方法が自動的に選択されます。 次のオプションがサポートされています。 POLICYOFFLINE - The Edge Extension is automatically installed per system via the Group Policy Offline method, the equivalent of calling the /Edge-Policy-Offline command using the SetupExtensions tool. POLICYONLINE - The Edge Extension is automatically installed per system via the Group Policy Online method, the equivalent of calling the /Edge-Chromium-PolicyGlobal command using the SetupExtensions tool. MANUALPERMACHINE - The Edge Extension is installed for all users, the equivalent of calling the /Edge-Chromium-Global command using the SetupExtensions tool. NATIVEHOSTONLY - Only the Native Messaging Host component (ChromeNativeMessaging.exe) is installed, the equivalent of calling the /Edge-Chromium-NativeHostGlobal command using the SetupExtensions tool. 後方互換性を確保するため、古いインストール方法の名前 (STORE、GLOBAL) が維持されています。
DISABLE_SECURE_XAML	Windows サービスとしてインストールされた Robot の XAML ファイルのセキュリティを無効化できます。セキュリティ保護されていない XAML ファイルを使用すると、ユーザーはプロセス ファイルとロジックを読み取って変更できます。 次のオプションがサポートされています。 0 - 既定のオプションです。使用すると、Windows サービスとしてインストールされた Robot の XAML ファイルのセキュリティが有効化されます。 1 - Windows サービスの Robot の XAML ファイルのセキュリティが無効化されます。 このパラメーターは、クリーン インストールまたは更新時にのみ使用できます。
SERVICE_URL	ユーザーが対話型サインインを使用して接続する場合の、Orchestrator インスタンスの URL を定義できます。 指定した URL は、ユーザー モードの Robot についてのみ uipath.config ファイルに保存されます。サービス モードのインストールの場合、この引数は無視されます。 インストーラーを実行して旧バージョンからの更新または既存のインストールの変更を行う際、Robot をサービス モードからユーザー モードに切り替える場合 (RegisterService オプションは含めません)、このパラメーターを使用できます。
ORCHESTRATOR_URL	クリーン インストールでは、自動更新情報を取得するために使用する Orchestrator のメイン URL を指定できます (例: https://orchestrator.local/organizationName/tenantName)。
TELEMETRY_ENABLED	使用状況データの収集機能は、Studio および Robot のインストール時に無効化できます。 このパラメーターは、クリーン インストールまたは更新時にのみ使用できます。 テレメトリは Studio および Robot に対して既定で有効化されています。無効化するには、クリーン インストールまたは更新を実行するたびにパラメーターに次の値を使用します。 TELEMETRY_ENABLED=0 これにより、Studio と Robot の両方のテレメトリが無効化されます。 テレメトリを有効化する場合は、このパラメーターを含めないか、次の値と一緒に含めます。 TELEMETRY_ENABLED=1 For more information about usage data collection and how to change telemetry settings, see the Opting Out of Telemetry document.
ENABLE_PIP	コマンドラインから UiPath をインストールするときに、マシンのピクチャ イン ピクチャ機能を有効化することができます。 そのためには、以下のパラメーターを使用します。 ENABLE_PIP=1 例： UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages ENABLE_PIP=1
INSTALLER_LANGUAGE	インストーラーの表示言語を選択できます。指定しない場合、Windows の言語設定によってインストーラーの言語が決定されます。言語を指定するには、INSTALLER_LANGUAGE=<language_code> パラメーターを入力します。次のオプションが利用できます。 中国語 (簡体字): INSTALLER_LANGUAGE=2052 英語: INSTALLER_LANGUAGE=9 フランス語: INSTALLER_LANGUAGE=12 ドイツ語: INSTALLER_LANGUAGE=7 日本語: INSTALLER_LANGUAGE=17 韓国語: INSTALLER_LANGUAGE=1 ポルトガル語 (ポルトガル): INSTALLER_LANGUAGE=22 ポルトガル語 (ブラジル): INSTALLER_LANGUAGE=1046 ロシア語: INSTALLER_LANGUAGE=25 スペイン語 (スペイン): INSTALLER_LANGUAGE=10 スペイン語 (メキシコ): INSTALLER_LANGUAGE=2058 トルコ語: INSTALLER_LANGUAGE=31
ORCHESTRATOR_AUTO_SIGNIN	If you install the attended robot in user mode and your environment is configured to use SSO with Azure Active Directory, this enables automatic sign-in to your account. This parameter must be used together with ORCHESTRATOR_URL. このオプションを有効化するには、ORCHESTRATOR_AUTO_SIGNIN=1 を使用します。
ENFORCE_DEFAULT_SERVICE_URL	ユーザー モードのインストールの場合、このパラメーターは既定のサービス URL を適用します。 このオプションを有効化するには、ENFORCE_DEFAULT_SERVICE_URL=1 を使用します。 ORCHESTRATOR_URL も有効化する必要があります。

同期インストールを実行する

インストールの完了後に追加の設定を行う場合は、インストーラーを同期的に実行できます。これにより、インストーラーの完了後に実行する他のコマンドを追加できます。たとえば、インストールに続いて、ロボット接続の設定やフィードの設定ができます。

次のスクリプトでは、インストールを実行し、インストールが成功した場合に実行する他のコマンドを追加できます。

:: Runnning the MSI synchronously
start /wait /b UiPathStudio.msi /Q
:: Assert the exit code and continue accordingly
set "_isSuccess="
if %ERRORLEVEL% EQU 0 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 1641 Set "_isSuccess=1"
if %ERRORLEVEL% EQU 3010 Set "_isSuccess=1"
:: test for success and run follow-up commands
if (%_isSuccess% EQU 1) (
    echo "success"
) ELSE (
    echo "fail"
)

例

以下の例では、UiPathStudio.msi インストーラーが置かれているディレクトリにいることを前提としています。たとえば、cd D:\UiPathInstaller などのコマンドでこれを行うことができます。

• Studio のインストールと Robot の Windows サービスとしてのインストールを実行し、アクティビティ パッケージをインストールします。 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages

• 現在のユーザーに対してのみ、Studio と Robot をユーザー モードでインストールします。 - UiPathStudio.msi MSIINSTALLPERUSER=1 ADDLOCAL=Studio,Robot

• デスクトップ スイート全体をサイレント モードでインストールします。 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages,StartupLauncher,JavaBridge /Q

• ポリシーを使用して、デスクトップ スイート全体と Chrome 拡張機能をサイレント モードでインストールします。 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages,ChromeExtension CHROME_INSTALL_TYPE=POLICYONLINE /Q

• サイレント モードで、Studio をインストールし、Robot を Windows サービスとしてインストールし、アクティビティ パッケージをインストールする (すべてを D:\UiPath フォルダーにインストール) - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages APPLICATIONFOLDER=D:\UiPath /Q

• サイレント モードで Robot を Windows サービスとしてインストールし、Orchestrator に接続する -

  UiPathStudio.msi ADDLOCAL=Robot,RegisterService CONNECTIONSTRING=https://demo.uipath.com/api/robotsservice/GetConnectionData?tenantId=1 /Q

• Studio のインストールと Robot の Windows サービスとしてのインストールと、2 つのカスタム アクティビティ フィードの追加をサイレント モードで実行します。 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService CUSTOM_NUGET_FEEDS="Feed Name1,https://my.custom.nuget.feed; FeedName2,D:\RPA\Activities\Packages\" /Q

• Studio 、Windows サービスとして登録された Robot、ローカル アクティビティ フィードのインストールとライセンスの取得をサイレント モードで実行します。 - UiPathStudio.msi ADDLOCAL=Studio,Robot,RegisterService,Packages CODE=1234567890 /Q

• Robot を Windows サービスとしてインストールし、オフィシャル オンライン フィードを無効化します。 - UiPathStudio.msi ADDLOCAL=Robot,RegisterService NUGET_OPTIONS=DisableOnlineFeeds

• Chrome 拡張機能をアンインストールします。 - UiPathStudio.msi REMOVE=ChromeExtension /Q

• Attended ロボットのインストール中に自動更新接続を設定します。- UiPathStudio.msi ADDLOCAL=Robot, SERVICE_URL="https://demo.uipath.com/myorg/mytenant"

• Unattended ロボットのインストール中に自動更新接続を設定します。- UiPathStudio.msi ADDLOCAL=Robot,RegisterService ORCHESTRATOR_URL="https://demo.uipath.com/myorg/mytenant/orchestrator_"