この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

CLI を使用したパッケージのインストール

Salesforce CLI で作業している場合、force:package:install コマンドを使用してスクラッチ組織または対象登録者組織にパッケージをインストールできます。

スクラッチ組織にパッケージをインストールする前に、次のコマンドを実行してすべてのパッケージをリストし、ID またはパッケージの別名を見つけます。

1sfdx force:package:version:list

インストールするバージョンを特定します。パッケージの別名またはパッケージ ID (04t から始まる) を指定して次のコマンドを入力します。

1sfdx force:package:install --package "Expense Manager" --targetusername jdoe@example.com

すでにデフォルトのユーザ名でスクラッチ組織を設定している場合は、パッケージバージョン ID のみを入力します。

1sfdx force:package:install --package "Expense Manager"

別名を定義 (-a パラメータを使用) している場合、--targetusername でユーザ名の代わりに別名を指定できます。

メモ

インストールに関する状況メッセージが CLI に表示されます。

1Waiting for the subscriber package version install request to get processed. Status = InProgress Successfully installed the subscriber package version: 04txx0000000FIuAAM.

パッケージインストールのタイムアウトの制御

force:package:install コマンドを実行すると、パッケージバージョンが対象組織で使用可能になるまで数分かかる場合があります。進行状況を確認する場合、次のパラメータを force:package:install に追加できます。このパラメータは、互いに連動して機能する個別のタイマーを表します。

  • --publishwait は、登録者パッケージバージョン ID が対象組織で使用可能になるまで待機する最長時間 (分単位) を決定します。この時間が経過すると、インストール要求がキャンセルされます。
  • --wait は、パッケージが使用可能になった後、インストールが完了するまで待機する最長期間 (分単位) を決定します。パッケージが対象組織で使用可能になる前に --publishwait 期間がタイムアウトした場合、--wait 期間は開始しません。

たとえば、次のコマンドを使用してパッケージをインストールする場合、インストールが完了またはタイムアウトするまで最長 15 分間待機する可能性があります。

1sfdx force:package:install --package "Expense Manager" --publishwait 5 --wait 10

--publishwait を 0 に設定した場合、パッケージインストールはただちにエラーで失敗します。例外は、そのパッケージバージョンがすでに対象組織で使用可能な場合です。その場合、インストールは続行され、10 分以内に完了するか、--wait の値に基づいてタイムアウトします。

メモ