コマンドラインオプション

Blue Prismには、コマンドラインスイッチを受け入れる2つのユーティリティがあります。

  • Automate.exe - グラフィカルなBlue Prismアプリケーション。このアプリケーションからのメッセージやフィードバックはすべて視覚的に行われます。リターンコード0は成功を示します。0以外のリターンコードはエラーを示します。
  • AutomateC.exe – メッセージとフィードバックを（標準出力経由で）コマンドラインに返すコマンドラインユーティリティ。リターンコード0は成功を示します。0以外のリターンコードはエラーを示します。

ヒント：

  • /helpスイッチを使用すると、AutomateCに動的ヘルプを使用できます。Automate.exeで/helpスイッチを指定すると、このドキュメントがグラフィカルウィンドウで表示されます。
  • 一部のスイッチでは、追加のパラメーターが必要です（以下では <parameter>として示します）。これらのパラメーターはスイッチの後に入力する必要があります。
  • スイッチとパラメーターはスペースで区切ります。パラメーターの値にスペースやその他の特殊文字が含まれている場合は、値を「二重引用符」で囲む必要があります。このため、実際の値に引用符を含めることはできません。引用符を含めないように注意してください。
  • XMLを渡す場合は、xml文字列を引用符で囲む必要があります。引用符は標準入力でパラメーターのXML文字列の開始/終了を区切るために使用されるため、xml属性は単一引用符で区切ることをお勧めします。また、パラメーターxml内の引用符ごとに2つの引用符を入力することで、存在する引用符をエスケープすることもできます。

  • Blue Prismを「admin」ユーザー専用のリソースPCとして実行します。

    automate /resourcepc /user admin mypwd

    または、シングルサインオンユーザー用として実行します。

    automate /resourcepc /sso

  • Blue PrismをパブリックリソースPCとして実行します。

    automate /resourcepc /public

  • ローカルPCでプロセスを実行します。

    AutomateC /run "My Scheduled Process" /user admin mypwd

    または、シングルサインオンユーザー用として実行します。

    AutomateC /run "My Scheduled Process" /sso

  • 起動パラメーターを指定してリモートPCでプロセスを実行します。

    AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"

  • メインのBlue Prismアプリケーションを起動せずに、バックグラウンドのプロセスアラートモニタリングを開始します。

    automate /alerts /user admin mypwd

    または、シングルサインオンユーザー用として実行します。

    automate /alerts /sso

Automate.exe - 使用可能なスイッチ

クイックヘルプのヒントをコマンドラインの標準出力に出力します。

Blue PrismをリソースPCモードで起動します。/publicスイッチを追加すると、すべてのBlue PrismユーザーがリソースPCを利用できるようになります。追加しない場合は、/userオプションまたは/ssoオプションで指定されたユーザーのみが利用できます。

このオプションを/resourceスイッチと混同しないでください。

許可が昇格されたランタイムリソースの開始と実行は、自動化されているアプリケーションとのやり取りに影響する場合があることにご注意ください。通常、ランタイムリソースの許可は、対象アプリケーションのユーザーコンテキストの許可と一致する必要があります。

/resourcepcスイッチとの組み合わせでのみ使用されます。実行モードで説明されているように、リソースPCを公開します。

/resourcepcスイッチとの組み合わせでのみ使用され、所定の捺印が押された証明書を使用してリソースPCへの接続でトランスポートセキュリティ（SSL/TLS）を有効にします。この証明書は、ユーザーまたはマシンの証明書ストアにインストールされている必要があります。

トランスポートセキュリティを有効にすると、Control Roomおよびスケジューラーからの接続とリソースにルーティングされる公開Webサービスの両方に影響します。証明書のCNは、リソースへの接続に使用されるアドレスと一致する必要があります。また、接続するクライアントは、証明書の発行元のCAを信頼する必要があります。

（詳細設定）/resourcepcスイッチとの組み合わせでのみ使用され、このデバイスでホストされるパブリッシュされたWebサービスと関連リソース（WSDLなど）の表示されるアドレス指定可能な場所をオーバーライドします。指定した値には、フルパスアドレス（例：「https://blueprismws.myorg.com:8181」）が含まれている必要があります。Blue Prismは、/ws/と関連するパスをローカルで利用可能なリソースに自動的に追加します。

指定したプレフィックスがこのデバイスにルーティングする有効なアドレスになるように、適切なネットワークルーティングを手動で適用することが重要です。

（詳細設定）/resourcepcスイッチとの組み合わせでのみ使用され、リスニングポートで受信したHTTP通信を無視するようランタイムリソースに指示します。このオプションは、Webサービスを公開するためのリソースが不要で、HTTPインターフェイスでリソースをコントロールする必要がない場合にのみ使用してください。

起動時に、指定された秒数の間、データベースが使用可能になるのを待機し、指定された秒数が経過すると接続を断念します。この間、接続は周期的に再試行されます。これは、小規模なインストールで起動時にリソースPCを同じマシン上のデータベース「サーバー」と一緒に実行している場合に役立つことがあります。このような場合、リソースPCの起動時にデータベースがすぐに接続を受け入れる準備ができないことがあります。たとえば、/dbwait 120を使用すると、2分間再試行してから接続を断念します。

/dbwaitコマンドを使用して、Blue Prism Login Agentサーバーサービスがタイムアウトするまでの接続待機時間の長さを設定できます。これは、すべてのリソースが同時に再起動される状況で便利です。そのような場合は、/dbwaitの時間を300（5分）に設定することをお勧めします。

詳細については、「Login Agent接続再試行時間を設定する」を参照してください。

/resourcepcスイッチとの組み合わせでのみ使用されます。リソースPC情報フォームはデフォルトで非表示になります。通知領域のコンテキストメニューを使用して再度表示できます（リソースPC通知アイコンアイコンをご覧ください）。

/resourcepcスイッチとの組み合わせでのみ使用されます。リソースPCは、ローカルマシンからのみコントロールできます。リモートリソースは、リソースPCの存在を認識しません。

/resourcepcスイッチとの組み合わせでのみ使用されます。Blue Prismがそれ自体をリソースPCとして使用できるようにするポートを指定します。この方法で、同じマシンから複数のリソースPCを実行できます。

このオプションは、特定のまれな状況で役立つ場合があります。以下は、その例です。

  • デフォルトポートをオーバーライドする

    デフォルトポートの8181がすでにネットワーク上の別のサービスに使用されている場合は、別のポートを使用できます。特別な理由がない限り、必ずネットワーク上のすべてのリソースPCに同じポートを使用します。

  • ターミナルサービスを使用する

    ターミナルサービスホストを操作するとき、Blue Prismは各リソースPC上で一度に1つのセッションしか実行できません。これは、Microsoftターミナルサービスの実装の技術的な制限によるものです。複数のリソースPCをそれぞれ異なるポートで実行することで、通常どおり1台のマシンで複数のセッションを実行できます。

プロセスアラートの対象となるリソースPCを決定します。指定されていない場合は、ローカルPCが使用されます。

このオプションを/resourcepcスイッチと混同しないでください。

必要に応じてBlue Prismのログイン認証情報を提供するために使用されます。データベースがシングルサインオン用に構成されている場合は、代わりに/ssoスイッチを使用してください。

シングルサインオン（SSO）構成で現在のユーザーの認証情報に基づいてコマンドを認証するようBlue Prismに指示します。データベースがシングルサインオン用に構成されていない場合は、代わりに/userスイッチを使用してください。

現在ログインしているオペレーティングシステムユーザーに、すべてのBlue Prism構成オプションを適用できるようにします。デフォルトでは、構成はすべてのユーザーに適用されます。

これらのパラメーターを組み合わせて使用すると、指定されたデータベース名と同じ名前の新しいデータベース接続を作成したり（/dbconnameも参照してください）、その接続を更新したりできます（存在する場合）。推奨されるSQL Server認証では、4つのパラメーターすべてを指定する必要があります。Windows認証の場合は、ユーザー名とパスワードを省略する必要があります。接続も現在の接続に設定されます。この後、Blue Prismは終了します。

/setdbserverと組み合わせて使用すると、直接データベース接続ではなく、可用性グループ接続を指定できます。この場合、「databaseservername」は可用性グループリスナーの名前になります。

/agと組み合わせて使用すると、可用性グループリスナーのポートを指定できます。指定しない場合は、デフォルトの1433が使用されます。

/agと組み合わせて使用すると、マルチサブネットフェイルオーバーを有効にするように指定できます。

指定されたホストと同じ名前の新しいBlue Prismサーバー接続を作成します。（/dbconname、/connectionmode、/bpserversecureも参照してください）。接続も現在の接続に設定されます。この後、Blue Prismは終了します。

/setdbserverまたは/setbpserverオプションと組み合わせて使用すると、デフォルトの接続名を使用する代わりに特定の接続名を指定できます。これらのパラメーターのいずれも指定せずに使用された場合は、使用するデータベース接続の名前を指定します。

/setbpserverオプションと組み合わせて使用すると、クライアントとBlue Prismサーバーの間の接続に使用される接続モードを選択できます。このオプションは、Blue Prismサーバー構成で構成した対応する値と一致する必要があります。

デフォルト値は0です。利用可能な接続モードは以下のとおりです。

  • 0 - WCF：メッセージの暗号化とWindows認証を使用するSOAP
  • 1 - WCF：トランスポートの暗号化とWindows認証を使用するSOAP
  • 2 - WCF：トランスポートの暗号化を使用するSOAP
  • 3 - .NET Remoting：セキュア
  • 4 - .NET Remoting：安全でない
  • 5 - WCF：安全でない

/setbpserverオプションと組み合わせて使用すると、Blue Prismサーバー接続のセキュリティを無効できます。接続を保護するための代替手段を用意していない限り、これは決して使用しないでください。

/bpserversecureオプションは推奨されていないため、代わりに/connectionmodeオプションを使用してください。

バックグラウンドのプロセスアラートモニタリングを開始します。適切なユーザーのプロセスアラート構成が使用されるように、/Userまたは/ssoのいずれかのスイッチと組み合わせて使用する必要があります。

Blue Prismアプリケーションの優先度を指定されたモードに設定します。通常は、Blue PrismがリソースPCとして機能している場合に、Blue Prism Windowsプロセスの優先度をコントロールするために使用されます。これは、Blue PrismにPC上の他のプロセスよりも高い優先度を割り当てる必要がある（そうしないとそれらのプロセスによってCPUが占有され、Blue Prismが効率的に動作できなくなるおそれがある）場合に役立ちます。有効なモードは以下のとおりです。

  • below - 通常の優先度より下
  • above - 通常の優先度より上
  • high - 高い優先度
  • realtime - 可能な最も高い優先度

セッションに起動パラメーターを指定するため、/runパラメーターと組み合わせて使用されます。

paramsxmlパラメーターには、有効なBlue Prismパラメーターxmlを引用符（""）で囲んで含める必要があります。引用符は標準入力でパラメーターのXML文字列の開始/終了を区切るために使用されるため、xml属性は単一引用符（''）で区切ることをお勧めします。例：

AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"

また、パラメーターxml内の引用符ごとに2つの引用符を入力することで、存在する引用符をエスケープすることもできます。例：

AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"

シングルサインオンユーザーは、上の例の/userスイッチの代わりに/ssoスイッチを使用する必要があります。例：

AutomateC /run "Excel Test" /resource YourPCHostName /sso /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"

データベース構成フォームを表示します。ユーザーがこのフォームを終了（［OK］または［キャンセル］ボタンを使用）すると、アプリケーションは終了します。

AutomateC.exe - 使用可能なスイッチ

クイックヘルプのヒントをコマンドラインの標準出力に出力します。

データベース

構成済みのデータベース接続を使用してデータベースを作成します（Automate.exeの/setdbserverを参照）。必要なパスワードは、構成済みデータベース接続の一部として提供されているものです。

これは、/replacedbスイッチとは異なり、同じ名前の既存のデータベースをすべてドロップします。一方、/replacementbスイッチは、データベース自体をドロップせずに、データベース内の既存のテーブルをドロップします。

構成済みのデータベース接続を使用してデータベースを作成します（Automate.exeの/setdbserverを参照）。必要なパスワードは、構成済みデータベース接続の一部として提供されているものです。

これは、/createdbスイッチとは異なり、同じ名前のデータベースがすでに存在する場合は、そのデータベース内の既存のテーブルのみをドロップします。一方、/createdbコマンドは、データベース全体をドロップして再作成します。

必要に応じて既存のデータベースをアップグレードします。必要なパスワードは、構成済みデータベース接続の一部として提供されているものです。

AutomateC.exeでのこれらのコマンドの使用法は、Automate.exeでの使用法とまったく同じです。それぞれ（/dbconname、/user、/sso、/resource、/port、/startp）の詳細については、上を参照してください。

ライセンスキー

指定されたファイルのライセンスキーをBlue Prismデータベースに追加します。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

ライセンスは、クライアントアプリケーションのシステムマネージャーを使用して管理することもできます。

指定されたファイルのライセンスキーをBlue Prismデータベースから削除します。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

ライセンスは、クライアントアプリケーションのシステムマネージャーを使用して管理することもできます。

登録

COMビジネスオブジェクトをローカルマシンで使用できるように登録します。これは、System Managerの「外部ビジネスオブジェクト」領域にアクセスするのと同じです。

clsidパラメーターはCOMクラスIDを参照します。

WebサービスをBlue Prismプロセスで使用できるように登録します。これは、システムマネージャーの「Webサービス領域」にあるウィザードを使用してWebサービスを登録するのと同じです。

  • /userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。
  • オプションで/objectnameスイッチと組み合わせて使用することもできます。
  • オプションで/timeoutスイッチを指定できます。
  • WSDLドキュメントを取得するために認証情報が必要な場合は、/wsauthスイッチを使用できます。

<servicename>識別子は、WebサービスのWSDLドキュメントに表示されるサービスの名前と一致する必要があります（WSDLドキュメントの詳細については、Webサービス用語集を参照してください）。1つのWSDLドキュメントで複数の異なるWebサービスを記述できるため、これは必須です。指定する名前は、/objectnameスイッチで指定する名前とは異なります。このスイッチでは、WebサービスがBlue Prismプロセス内で内部的に認識される名前を指定します。

<WSDLURL>パラメーターには、対象となるWebサービスのWSDLドキュメントの場所（URL）を指定する必要があります。これはhttpまたはhttpsのいずれか適切なほうを使用して取得されます。

Webサービスを登録解除します。これは、システムマネージャーの「Webサービス」領域にあるウィザードを使用してWebサービスを削除するのと同じです。

  • /userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

<servicename>識別子は、WebサービスがBlue Prismプロセス内で内部的に認識されている名前と一致する必要があります。

/regwebserviceスイッチと組み合わせて使用され、登録後にWebサービスに付与されるビジネスオブジェクト名を指定します。

/regwebserviceスイッチと組み合わせて使用され、WSDLドキュメントをダウンロードするときにhttpリクエストで使用されるユーザー認証情報を指定します。このスイッチは、WSDLがホスティングサーバーによってパスワードで保護されている場合にのみ使用する必要があります。

/regwebserviceスイッチと組み合わせて使用され、Webサービスに関連付けられるタイムアウト値をミリ秒単位で指定します。Webサービスからのレスポンスを待っているときに実行時に適用されるタイムアウトになります。この値は、後でシステムマネージャーにアクセスしてWebサービスを編集することで変更できます。

このスイッチは、オプションで/regwebserviceコマンドと組み合わせて使用できます。使用しない場合は、デフォルト値の10,000ミリ秒が適用されます。

レポート

指定されたファイルにシステムレポートを書き出します。システムレポートは、システムの現在の状態（セッションとログエントリの数、キュー項目の数、プロセスの検証状態など）に関する広範な概要です。

システム内の各ユーザーのすべての役割と関連付けられた許可に関するレポートを生成します。

指定されたファイルに要素の使用状況レポートをCSV形式で書き出します。レポートするビジネスオブジェクトを指定するには、/processオプションを使用します。レポートには、アプリケーションモデルの各要素が使用されているページとステージの詳細が含まれます。

インポートまたはエクスポートする

デフォルトでファイル内のID（IDが存在する場合。存在しない場合は、新しいIDが生成されます）を使用してBlue Prismプロセス（またはビジュアルビジネスオブジェクト）をデータベースにインポートします。この動作をオーバーライドするには、/forceidを参照してください。
filespecパラメーターは、インポートされるファイルの場所を参照します。

デフォルトでは、インポートされるプロセス/オブジェクトが選択した環境にすでに存在する場合、この操作は失敗します。これを回避するには、/overwriteを参照してください。

Blue Prismリリースファイル（.bprelease）またはBlue Prism Skillファイル（.bpskill）をデータベースにインポートします。このアクションは、非対話的で、可能な場合には競合が自動的に処理されることを除き、Blue Prismクライアント（［リリース］タブを参照）を使用して対話的にインポートを実行するのと機能的に同じです。通常、デフォルトでは、インポートされるアイテムがすでに存在するデータベース内の場所が上書きされます。ただし、競合が発生すると、リリースの非対話的インポートが妨げられます。次の表は、競合の処理をまとめたものです。

競合

結果
データベースに同じID/名前とタイプのアイテムがすでに存在する アイテムが上書きされる
インポート後にプロセスをパブリッシュまたは廃止する必要がある プロセスがパブリッシュ/廃止される
次に、インポートの失敗につながる競合の例を示します。
  • ユーザーがタイルデータソースをインポートするための適切なデータベース権限を持っていない
  • デフォルトの暗号化スキームが構成されていないため、認証情報をインポートできない
  • リリース内のオブジェクトがデータベース内の既存のプロセスと同じ名前（またはID）を持つ
  • リリース内のプロセスがデータベース内の既存のオブジェクトと同じ名前（またはID）を持つ
 リリースはインポートされない

新しい認証情報を対話的にインポートする場合、ユーザーはユーザー名とパスワードの入力を求められます（この情報はエクスポートファイルに書き込まれないため）。非対話的にインポートする場合、認証情報は空白のユーザー名/パスワードでインポートされるため、Blue Prismクライアントを使用し手動で更新する必要があります。

filespecパラメーターは、インポートされる.bpreleaseファイルの場所を参照します。

Blue Prismプロセス（またはビジュアルビジネスオブジェクト）をデータベースからローカルファイルシステムにエクスポートします。

指定されたBlue Prismパッケージの現在のバージョンをデータベースからローカルファイルシステムにエクスポートします。前回リリースされたパッケージをエクスポートするには、オプションの[/release <releasename>]パラメーターを使用します。

インポート対象のファイルで定義されているIDを使用する代わりに、指定したIDをプロセスに使用するように強制するには、/importと組み合わせて使用します。

「new」キーワードを使用すると、インポートされるオブジェクト用の新しいIDが生成されます、このキーワードを使用しない場合は、有効なGUIDを指定する必要があります。

デフォルトでは、インポートされるプロセス/オブジェクトがすでにデータベースに存在する場合、/importは失敗します。
/overwriteオプションを使用すると、新しいバージョンのプロセス/オブジェクトがインポートされ、既存のプロセス/オブジェクトがオーバーライドされます。

インポートされるプロセスやオブジェクトと名前が同じで、IDが異なる別のプロセス/オブジェクトが存在する場合、インポート操作は失敗します。/overwriteは、同じIDを持つプロセス/オブジェクトが見つかった場合にのみ機能します。このケースに対処するには、製品に含まれているインポートウィザードを使用できます。

公開

指定されたBlue Prismプロセスをパブリッシュします。プロセスの名前にスペースが含まれる場合は、名前を引用符で囲む必要があります。

指定されたBlue Prismプロセスのパブリッシュを解除します。プロセスの名前にスペースが含まれる場合は、名前を引用符で囲む必要があります。

指定されたBlue PrismオブジェクトまたはプロセスをWebサービスとして公開し、外部アプリケーションで使用できるようにします。オブジェクト名またはプロセス名にスペースが含まれる場合は、名前を引用符で囲む必要があります。

オプションの/forcedoclitencodingが存在する場合、WebサービスはWS-Iに準拠するため、常にDocument/Literal形式のSOAPメッセージを返します。

/forcedoclitencodingパラメーターが存在しない場合は、グローバル名前空間を使用するよう強制できます。

以前にWebサービスとして公開されていたBlue Prismオブジェクトまたはプロセスを隠します。オブジェクト名またはプロセス名にスペースが含まれる場合は、名前を引用符で囲む必要があります。

暗号化

指定されたキューで使用される暗号化方式を設定します。暗号化を正しく機能させるには、指定された方式をこの環境内に構成する必要があります。Blue Prismサーバーの構成で設定されるデフォルトの方式名は、デフォルトの暗号化方式と呼ばれます。

キューの暗号化キーを無効にするには、//resetencryptスイッチを参照してください。

/queuenameと組み合わせて使用する必要があります。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

指定されたキューの暗号化方式をリセットして、そのキューが暗号化されないようにします。

/queuenameと組み合わせて使用する必要があります。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

このオプションは、現在選択されている方式に従って暗号化されていない認証情報、リソース画面キャプチャ、またはキュー項目データを再暗号化します。これは、暗号化方式を削除する前に古いキーを取り消す場合に使用されます。パラメーター/batchsizeは更新されたレコードをデータベースにコミットする頻度（デフォルトは1000）をコントロールし、/maxbatchesは処理するバッチの数（デフォルトは1）をコントロールします。

コマンドを実行すると、次のようになります。

  • デフォルトの暗号化方式として構成されているものとは異なる方式を使用して現在暗号化されている認証情報または例外スクリーンキャプチャは復号され、デフォルトの暗号化方式を使用して再暗号化されます。
  • ワークキューで構成されているものとは異なるスキームを使用して現在暗号化されている暗号化されたワークキュー項目は、復号された後、ワークキューに関連付けられた暗号化方式を使用して再暗号化されます。

構成されたパラメーター/batchsizeに基づいて、構成された値/maxbatchesに達するまで処理が繰り返されます。

/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。また、「セキュリティ - 暗号化方式を管理」許可へのアクセスが必要です。

Blue Prismサーバーの構成に必要な暗号化メソッドを適用します。Blue Prismのデフォルトの暗号化を使用できる他、指定した証明書をインストールすることもできます。このコマンドのオプションは次のとおりです。

  • /configencrypt - サーバー構成に使用されている暗号化メソッドを表示します。
  • /configencrypt default - Blue Prismのデフォルトの暗号化を適用します。Blue Prismシステム管理者パスワードを指定する必要があります。
  • /configencrypt thumbprint - configencryptメソッドを、拇印を指定した独自の証明書に変更します。Blue Prismシステム管理者パスワードを指定する必要があります。
  • /configencrypt thumbprint /forceconfigencrypt - エラーのオーバーライドを強制します。警告が表示される場合があります。Blue Prismシステム管理者パスワードを指定する必要があります。

例：

現在の暗号化メソッドを表示する：

AutomateC /configencrypt /user admin password

デフォルトの暗号化メソッドに設定する：

AutomateC /configencrypt default /user admin password

指定した証明書サムプリントを使用するように設定する：

AutomateC /configencrypt bc6269e89048cbf5553601cc0314b291609d9f3 /user admin password

ワークキュー

システムマネージャーで手動によりキューを作成するときに必要になるワークキューを、keyfield、running、maxattemptsの各値を使用して作成します。

/queuenameと組み合わせて使用する必要があります。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

ワークキューからデータをエクスポートし、そのデータを<filespec>で指定された場所に保存します。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。/queuenameと組み合わせて使用する必要があります。/queuefilterと/clearexportedの一方または両方を組み合わせて使用できます。
/exportqueueでは、/userまたは/ssoスイッチのいずれかを使用してユーザーの認証情報を提供する必要があります。また、次のいずれかの許可へのアクセスが必要です。キュー管理へのフルアクセス、キュー管理への読み取り専用アクセス

ワークキューから作業済みケース（完了済みまたは例外としてマークされたケース）をクリアします。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。/queuenameと組み合わせて使用する必要があります。
/ageスイッチを使用すると、指定された期間よりも古い作業済みアイテムのみがキューから削除されます。このスイッチを使用しない場合は、すべての作業済みアイテムが指定されたキューから削除されます。

代わりに、/exportqueueコマンドと/clearexportedを組み合わせて使用することもできます。この組み合わせを使用すると、プロセスで削除されたアイテムのレコードを生成できます（このコマンドでは、このようなレコードは作成されません）。

/queueclearworkedと組み合わせて使用され、指定された期間より古い作業済みアイテムをすべて削除します（これには、これ以前に例外としてマークされたアイテムを含みます）。
/archiveおよび/restorearchiveと組み合わせて使用され、日付範囲に基づく選択を省略し、特定の期間よりも古いセッションを選択します。値は、数値の後に「y」（年）、「m」（月）、「w」（週）、または「d」（日）のいずれかを指定したものです。たとえば、「6m」は、6か月より古いログをアーカイブするように指定します。

/exportqueueや/createqueueなどのキュー関連のコマンドと組み合わせて使用する場合にキューの名前を指定します。

/exportqueueを使用してキューをエクスポートするときに使用するフィルターの名前を指定します。Control Roomの「キュー管理」領域で作成されたフィルターの名前です。

/exportqueueと組み合わせて使用した場合、エクスポートされた作業済みアイテムおよび参照済みアイテムをキューから削除します。
/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。また、「キュー管理へのフルアクセス」許可へのアクセスが必要です。

リソースプール

AutomateCコマンドラインプログラムを使用すると、リソースプールを作成および削除したり、既存のプールにリソースを追加および削除したりできます。
リソースプールアクションを実行するには、有効なログイン詳細を入力する必要があります。

指定された名前でリソースプールを作成します。

指定されたリソースプールを削除します。

指定されたプールにリソースを追加します。
リソース名が指定されていない場合は、ローカルリソースがプールに追加されます。

リソースが存在するプールからそのリソースを削除します。
リソース名が指定されていない場合は、ローカルリソースがそのプールから削除されます。

スケジュール

AutomateCコマンドラインプログラムを使用すると、スケジュールを開始または削除したり、レポートやタイムテーブルを表示したりできます。
スケジュールアクションを実行するには、有効なログイン詳細を入力する必要があります。

/startschedule、/deleteschedule、/viewschedtimetable、/viewschedreportの各アクションと組み合わせて使用するスケジュールの名前を指定します。

/scheduleスイッチの後続のパラメーターは、別のスイッチ（「/」文字で始まるパラメーター）またはコマンドの最後に到達するまで、スケジュール名として扱われます。
スケジュールが指定されていない場合、このコマンドは、通常はすべてのスケジュールに対して実行されているものとして扱われます。

指定されたスケジュールを現在の時間に開始します。スケジューラーが実行されている場合は、30秒以内にスケジュールを実行する必要があります。

指定したスケジュールが実行されていない場合は、スケジュールと関連ログが削除されます。指定したスケジュールが以前に実行されている場合、スケジュールは削除済みとしてマークされますが、既存のログは保持されます。

スケジュールレポートまたはタイムテーブルの出力形式を、「txt」（判読可能）または「csv」（カンマ区切り変数）のいずれかで指定します。形式が明示的に指定されていない場合、デフォルトは「txt」です。

指定されたタイムテーブルを出力します。
Blue Prismクライアントで作成および構成された名前付きのタイムテーブルを指定できます。
または、タイムテーブルの実行を開始する日付、表示する日数、ダウンロード時の形式を指定して、アドホックタイムテーブルを指定することもできます。

指定されたレポートを出力します。
Blue Prismクライアントで作成および構成された名前付きレポートを指定できます。
または、レポートに含める最新の日付、表示する過去の日数、ダウンロード時の形式を指定して、アドホックレポートを指定することもできます。

環境変数

既存の環境変数を設定します。既存の環境変数がない場合、このコマンドを実行すると新しい環境変数が作成されます。

環境変数を削除します。

アーカイブ

セッションログをファイルにアーカイブします。詳細については、「アーカイブ」を参照してください。オプションを指定しない場合、すべてのセッションログがアーカイブされます。アーカイブされるログの範囲を制限するには、/ageオプションか、/fromオプションと/toオプションの組み合わせを使用します。/processを使用して、アーカイブを特定のプロセスのログに制限することもできます。

セッションログをエクスポートせずに削除するには、/deleteオプションを追加します。

セッションログをファイルからデータベースに復元します。詳細については、「アーカイブ」を参照してください。オプションを指定しない場合、すべてのセッションログが復元されます。アーカイブされるログの範囲を制限するには、/ageオプションか、/fromオプションと/toオプションの組み合わせを使用します。

アーカイブパスを設定します。これは、/archiveおよび/restorearchiveコマンドとシステムマネージャーインターフェイスで使用されるパスです。

/archiveおよび/restorearchiveと組み合わせて使用され、日付範囲の開始日（基準となる日付を含む）を設定します。

/archiveおよび/restorearchiveと組み合わせて使用され、日付範囲の終了日（基準となる日付を含まない）を設定します。

/queueclearworkedと組み合わせて使用され、指定された期間より古い作業済みアイテムをすべて削除します（これには、これ以前に例外としてマークされたアイテムを含みます）。
/archiveおよび/restorearchiveと組み合わせて使用され、日付範囲に基づく選択を省略し、特定の期間よりも古いセッションを選択します。値は、数値の後に「y」（年）、「m」（月）、「w」（週）、または「d」（日）のいずれかを指定したものです。たとえば、「6m」は、6か月より古いログをアーカイブするように指定します。

/archiveと組み合わせて使用され、アーカイブの対象を、指定されたプロセスを実行したセッションに制限します。/elementusageと組み合わせて使用され、レポートを生成するプロセスを選択します。

/archiveと組み合わせて使用され、最初にログをエクスポートせずにログを削除します。

ユーザーマッピング

Blue PrismとAuthentication Server間でユーザーをマッピングします。Authentication Server - ユーザーをマッピング許可が必要です。

inputcsvpath – マップされるユーザーの詳細を含むCSVファイルへのパスです。AutomateCの読み取りアクセスが必要です。

outputcsvpath - マッピングできなかったユーザーを含むCSVファイルのパスが書き込まれるパスです。AutomateCの読み取りおよび書き込みアクセスが必要です。

ステータス

実行中のセッションのステータスを取得します。SessionIDは、xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxの形式の固有IDです。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

与えられたリソース名のセッションを報告してください。結果は指定期間に制限することができます。全リソースを一覧表示するには、[All]をリソース名として使用します。

また、制限数やタイプ（m=分、h=時間、d=日、mm=月）を入力して返される結果を制限することもできます。たとえば/resourcestatus ABC:8181 1 dと入力すると、前日以降の指定した名称のリソースの全セッションが返されます。

/userスイッチで取得したユーザー認証情報が必要です。

サーバー

指定された名前で識別されるBPサーバー構成を作成または更新し、データベース接続名とリスニングポートを指定された値に構成します。

オプションの/connectionmodeスイッチを使用して接続モードを設定できます。

BPサーバー構成に暗号化方式が構成されていない場合は、新しい暗号化方式レコードが作成されます。デフォルトでは、この方式は「デフォルトの暗号化方式」という名前になり、AES 256（AESCryptoService）とランダムに生成されたキーを使用するように構成されます。または、/encryptionschemeスイッチを使用して、使用する設定を定義します。

/serverconfigスイッチと組み合わせて使用され、暗号化スキームの作成時に使用される構成を定義するために使用できるオプションのスイッチです。

<name>には、暗号化方式の名前を指定します。

<encryptionmethod>（オプション）には、使用する暗号化アルゴリズムを指定します。

  • 1 = Triple DES（192ビット）
  • 2 = AES-256 RijndaelManaged（256ビット）
  • 3 = AES-256 AesCryptoService（256ビット） - デフォルト

トリプルDES（192ビット）は後方互換性を確保するために用意されています。新しい暗号化方式は、この方法を使用しないように構成することを強くお勧めします。

次のコマンドを使用してApplication Server Controlled Resources（ASCR）の設定を構成します。

AutomateC /ascrconfig <servername> <conntype> <hostname> <port> <connectionmode> <certificatename> <clientcertificatename> <servercertstore> <clientcertstore>

<conntype>には次の値を指定できます。

  • 1 – grpc
  • 2 – wcf

<connectionmode>には次の値を指定できます。

  • 1 – certificate
  • 2 – windows
  • 3 – insecure

証明書オプションは、<connectionmode>で証明書が指定されている場合のみ必要です。

詳細については、「ASCR構成」を参照してください。

認証情報

指定された名前、パスワード、ユーザー名を使用して新しい認証情報を作成します。
ユーザー名とパスワードが不要な場合は、どちらも""で表すことができます。
何も指定されていない場合、一般的な認証情報タイプが作成されます。
/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。また、「セキュリティ - 認証情報を管理」許可へのアクセスが必要です。
作成された認証情報は、デフォルトですべてのユーザーの役割、リソース、プロセスに広範に使用できます。

指定された名前を使用して見つかった既存の認証情報を更新します。
/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。また、「セキュリティ - 認証情報を管理」許可へのアクセスが必要です。

/updatecredentialと一緒に使用して、認証情報のパスワードを更新します。

/updatecredentialと一緒に使用して、認証情報に保持されているユーザー名を更新します。

/updatecredentialまたは/createcredentialと一緒に使用して、認証情報に説明として保持されるテキストを設定します。

/updatecredentialまたは/createcredentialと一緒に使用して、認証情報の有効期限が切れる日付を設定します。日付はyyyyMMddの形式である必要があります。

/updatecredentialまたは/createcredentialと一緒に使用して、認証情報を無効とマークするかどうかを指定します。

/updatecredentialまたは/createcredentialと一緒に使用して、認証情報のタイプを指定します。サポートされている値である必要があります。

新しい認証情報プロパティを作成するか、すでに存在する場合は更新します。

/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。また、「セキュリティ - 認証情報を管理」許可へのアクセスが必要です。

システム設定を更新して、匿名ログインを許可します。

Windows認証

これは、Blue Prism 7.0.2以降でのみ使用できます。

Microsoft Negotiateセキュリティパッケージは、Blue Prismサーバー接続の認証時に、最後に使用された接続または指定された接続（/dbconnameスイッチを使用）のセキュリティサポートプロバイダー（SSP）としてNew Technology LAN Manager（NTLM）を選択しなければなりません。このオプションは、Kerberosが利用できない、あるいは構成されていない場合にNTLMを使用できるように提供されています（「SPNの構成」「」を参照）。例：/forcentlm true

これは、Blue Prism 7.0.2以降でのみ使用できます。

ユーザーのKerberosレルムがBlue Prismサーバーを実行するために構成されたアカウントのレルムと異なる場合、インタラクティブクライアントの各Blue Prismサーバー接続で構成する必要があります。例:/setkerberosrealm mycompany.com

Kerberosレルムは通常ドメイン名と同じですが、ITチームに正しい値を確認してください。これは、Blue Prismサーバーサービスを実行しているサービスアカウントのレルムと一致します。環境によっては、同じフォレスト内の別のドメインにサービスアカウントがある場合と同じ構成を適用する必要があります。

コマンドタイムアウト

製品が実行するSQLクエリの標準機能。タイムアウトの前にコマンドを実行して結果を返すまでの時間制限を設定します。デフォルトでは60秒に設定されています。

通常、結果を返すまでに最も時間がかかるSQLクエリで、タイムアウト前にコマンドを実行して結果を返すまでの時間制限を設定します。たとえば、ワークキューと連携するクエリでは、デフォルトで600秒に設定されています。

一般的に時間を要するログのタイムアウト前にコマンドを実行して結果を返すまでの時間制限を設定します。デフォルトでは0（無限）に設定されています。

これらのコマンドは、システム全体の不可逆的な変更を実装しているため、Blue Prismサポートチームから指示された場合にのみ使用してください。

Active Directory

データベース作成時のBlue Prism管理者のActive Directoryグループを決定します。シングルサインオンを使用する場合にのみ関連します。/setaddomainおよび/createdbまたは/replacementbのいずれかと組み合わせて使用する必要があります。

データベース作成時のBlue Prism管理者のドメイン名を決定します。シングルサインオンを使用する場合にのみ関連します。/setadadmingroupおよび/createdbまたは/replacementbのいずれかと組み合わせて使用する必要があります。

セッション管理

コマンドラインからプロセスを実行するために使用されます。processnameパラメーターにスペースが含まれる場合は、引用符で囲む必要があります。指定したプロセスが実行されるようにするには、そのプロセスをパブリッシュする必要があります（/publishを参照）。入力パラメーターは、/startpパラメーターを使用して指定できます。

プロセスを実行するにはユーザー認証情報が必要です。/userおよび/ssoを参照してください。例：

AutomateC.exe /run Process1 /user admin pwd

または

AutomateC.exe /run Process1 /sso

指定されたセッションに「停止リクエスト」を送信し、実行中のプロセスが決定ステージでIsStopRequested()関数を使用して確認できるフラグを設定します。

セッションID（GUID）またはセッション番号（番号）のいずれかを入力して、停止リクエストのフラグを付けるセッションを指定する必要があります。

セッション管理へのフルアクセス許可を持つ認証済みユーザー（/userまたは/ssoスイッチで指定されたユーザー）のみが実行できます。

雑則

セッションを作成、開始、削除するユーザーの制御を許可します。

オブジェクト/プロセス依存関係リポジトリがBlue Prismのアップグレードによって期限切れとマークされた場合に、そのオブジェクト/プロセス依存関係リポジトリを更新するよう要求します。「force」キーワードが指定されている場合、リポジトリはその現在の状態に関係なく更新されます。

指定されたセッションのログを取得します。SessionIDは、xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxの形式の固有IDです。/userまたは/ssoスイッチのいずれかを使用してユーザー認証情報を提供する必要があります。

ログは1行ずつ標準出力に書き込まれます。232 -1行のデータ制限がありますが、これは数百ギガバイトのデータに相当するため、実用上は影響ありません。

プロセスとビジネスオブジェクトのリストを出力します。