コマンド ラインまたは展開スクリプトを使用して Workspace ONE Access Desktop アプリケーションのインストーラ プログラムを実行するときには、このアプリケーションのためにさまざまなオプションを設定できます。

Workspace ONE Access Desktop インストーラに使用できるコマンド ライン オプション

クライアント アプリケーションのインストーラの .exe ファイルを Windows システムにダウンロードした後に、次のコマンドを実行してインストール オプションのリストを表示できます。
VMware-Identity-Manager-Desktop-n.n.n-nnnnnnn /?
n.n.n-nnnnnnn は、ファイルのバージョンとビルド番号です。ダイアログ ボックスに、コマンド ラインまたは展開スクリプトを使用してクライアント アプリケーションをインストールする場合に利用できるインストール オプションのリストが表示されます。
表 1. インストーラ コマンド ライン オプション
インストーラ オプション 説明
/? インストーラのコマンド ライン オプションを表示します。
/a 管理者用インストールを実行します。

詳細については、Windows インストーラに関するドキュメントを参照してください。

/a 既存の管理者用インストールまでの完全なパス 既存の管理者用インストールにパッチを適用します。
/s インストール中の初期設定ダイアログ ボックスを非表示にします。

サイレント モードでインストールするには、/s /v/qn を使用します。

サイレント モードでは、メッセージ、ダイアログ ボックス、プロンプトがインストール中に表示されません。通常このオプションは、展開スクリプトを作成してインストーラを実行する場合に使用します。

/v キー値ペア キー値ペアとして指定される、インストーラに渡す一連のパラメータ。key=value という形式を使用します。これらの引数は、通常、ThinApp パッケージのランタイム オプションや、Workspace ONE Access Desktop のランタイム オプションを構成します。
/c インストールの登録情報を消去します。
/l [ログ ファイルまでの完全なパス] 詳細なロギングを実行し、指定されたログ ファイルに保存します。

ログ ファイルを指定しない場合は、%TEMP% のデフォルト ログが使用されます。

/x インストーラを %TEMP% フォルダに解凍します。

/v オプションのキー値ペア

/v インストーラ オプションには、次のキー値ペアを使用できます。

表 2. /v インストーラ コマンド ライン オプションのキー
キー 説明
WORKSPACE_SERVER Workspace ONE Access サービスのホスト名または URL

Workspace ONE Access サービスのホスト名または URL を提供し、Workspace ONE Access Desktop アプリケーションがサービスと通信できるようにします。HTTPS は必須のプロトコルです。値は引用符で囲みます。

次の形式を使用します。

WORKSPACE_SERVER="https://VMwareIdentityManagerFQDN"

または

WORKSPACE_SERVER="VMwareIdentityManagerHostName"

例:

WORKSPACE_SERVER="https://myserver.mycompany.com"

WORKSPACE_SERVER="myserver"

INSTALL_MODE 次のいずれかになります。

COPY_TO_LOCAL

HTTP_DOWNLOAD

RUN_FROM_SHARE

実行時に Workspace ONE Access Desktop アプリケーションがどのような方法で ThinApp パッケージを取得するかを決定する展開モードを設定します。ThinApp パッケージは、仮想 Windows アプリケーションです。ThinApp パッケージは、Workspace ONE Access に統合されているネットワーク共有にあります。

  • COPY_TO_LOCAL: ユーザーに使用資格が付与されているパッケージはファイル コピーを使用してクライアント Windows システムにダウンロードされます。ユーザーが ThinApp パッケージを起動すると、仮想化されたアプリケーションがそのシステムでローカルに実行されます。使用資格が付与された ThinApp パッケージをユーザーが初めてダウンロードして使用するにあたり、そのパッケージをクライアント Windows システムに継続的に同期させる準備として、あらかじめそのクライアント Windows システムを ThinApp パッケージのネットワーク共有が参加している同じ Active Directory ドメインに参加させる必要があります。Windows システムへのログインに使用されるユーザー アカウントは、ネットワーク共有から ThinApp パッケージを取得するために使用するアカウントです。そのアカウントには、ネットワーク共有からファイルを読み取ってコピーするための適切な権限が必要です。
    重要: COPY_TO_LOCAL モードでは、ユーザーの Windows システムから ThinApp 共有にアクセスできる必要があります。
  • HTTP_DOWNLOAD: ユーザーに使用資格が付与されているパッケージは HTTP プロトコルを使用してクライアント Windows システムにダウンロードされます。ユーザーが ThinApp パッケージを起動すると、仮想化されたアプリケーションがそのシステムでローカルに実行されます。Workspace ONE Access Desktop アプリケーションは、ユーザーの Workspace ONE Access システム アカウントを使用して Workspace ONE Access に認証され、ユーザーに使用資格が付与されているパッケージのダウンロード リストを取得します。ThinApp パッケージのネットワーク共有へのアカウント ベースのアクセスを可能にするために Workspace ONE Access コンソールで提供される共有ユーザー アカウントは、Workspace ONE Access がリポジトリから ThinApp パッケージにアクセスするために使用するアカウントです。Workspace ONE Access のための共有ユーザー アカウントには、ネットワーク共有に対する読み取り権限が必要です。ユーザーがクライアント Windows システムにログインするために使用するアカウントおよびユーザーの Workspace ONE Access システム アカウントに対して、ネットワーク共有に対する権限は必要ありません。ThinApp パッケージのネットワーク共有が参加している同じドメインにクライアント Windows システムを参加させる必要はありません。このダウンロード方法では、一般に他のモードを使用する場合よりも遅くなります。このモードのメリットは、仮想アプリケーションの取得と実行のためにクライアント Windows システムを Active Directory ドメインに参加させる必要がないことです。
    重要: HTTP_DOWNLOAD オプションが動作するには、 Workspace ONE Access における ThinApp パッケージの統合をアカウント ベースのアクセス用に構成する必要があります。
    重要: Windows 2008 R2 または Windows 7 の Workspace ONE Access 2.6 以降では、TLS 1.0 を Workspace ONE Access で有効にするか、Windows 2008 R2 または Windows 7 システムで TLS 1.1 または 1.2 を有効にするまで、HTTP_DOWNLOAD オプションは機能しません。TLS 1.0 を Workspace ONE Access で有効にするには、 ナレッジベースの記事 2144805 を参照してください。Windows システムで TLS 1.1 または 1.2 を有効にするには、 https://support.microsoft.com/en-us/kb/3140245 にある Microsoft のドキュメントを参照してください。
    重要: HTTP_DOWNLOAD モードでは、ユーザーの Windows システムから IDP URL にアクセスできる必要があります。
  • RUN_FROM_SHARE: ユーザーが ThinApp パッケージを起動する際にネットワーク共有からクライアントの Windows システムに仮想アプリケーションがストリームされます。ThinApp パッケージは Windows システムに存在せず、仮想アプリケーションは Windows システムがネットワーク共有に接続できる場合にのみ実行されるので、RUN_FROM_SHARE オプションは ThinApp パッケージが存在するネットワーク共有に常に接続できる Windows システムに最適です。クライアント Windows システムを、ThinApp パッケージのネットワーク共有が参加している同じ Active Directory ドメインに参加させる必要があります。Windows システムへのログインに使用されるユーザー アカウントは、ネットワーク共有から ThinApp パッケージを取得するために使用するアカウントです。そのアカウントには、ネットワーク共有からファイルを読み取って実行するための適切な権限が必要です。
    重要: RUN_FROM_SHARE モードでは、ユーザーの Windows マシンから ThinApp 共有にアクセスできる必要があります。

デフォルト値は COPY_TO_LOCAL です。

どのモードも、ファイルと共有についての適切な権限がネットワーク共有に構成されていなければなりません。『Workspace ONE Access のインストールと構成』を参照してください。

重要: Workspace ONE Access Desktop をフローティング Horizon デスクトップにインストールする場合は、RUN_FROM_SHARE オプションを使用して、これらのステートレス Horizon デスクトップ システムに ThinApp パッケージがコピーされないようにします。

これらの構成のいずれかで Workspace ONE Access Desktop アプリケーションをインストールする場合、Windows システムにログインするユーザー アカウントには、ThinApp パッケージを取得できるように、ネットワーク共有に対する適切なファイルと共有の権限が必要です。

  • RUN_FROM_SHARE オプション
  • COPY_TO_LOCAL オプション(AUTO_TRY_HTTP オプションが有効になっていない場合、Workspace ONE Access でアカウント ベースのアクセスが構成されている場合)
POLLING_INTERVAL 秒単位の頻度 インストールした Workspace ONE Access Desktop アプリケーションと Workspace ONE Access との間の同期の頻度を秒単位で設定し、新しい ThinApp パッケージや使用資格がないかチェックします。指定しなければ、デフォルト値の 300 秒(5 分)が適用されます。

例:

POLLING_INTERVAL=600

ENABLE_AUTOUPDATE 0 または 1

自動更新チェックおよびダウンロード処理を有効または無効にします。有効にすると、インストールした Workspace ONE Access Desktop アプリケーションは、ダウンロードが必要な新しいアプリケーションがあるかどうかを自動的にチェックします。新しいバージョンがある場合、Workspace ONE Access Desktop アプリケーションは自動的にダウンロードして自身を新しいバージョンに更新します。このオプションは、デフォルトで有効になっています。

自動更新を無効にするには、この変数の値を 0 に設定します。指定しなければ、デフォルト値の 1 が適用されます。

自動更新のインストールには、管理者権限が必要です。
SHARED_CACHE 0 または 1

クライアント アプリケーションがインストールされる Windows システムの共通フォルダに ThinApp パッケージ キャッシュを配置するかどうかを決定します。Windows システムのすべてのユーザー アカウントが共通のキャッシュ場所を共有することを指定する場合は、この変数の値を 1 に設定します。デフォルトで、共通フォルダは %ProgramData%\VMware\Identity Manager Desktop\thinapp になります。

指定しなければ、デフォルト値の 0 が適用され、各 Windows ユーザー アカウントが個別のキャッシュを取得し、デフォルトの場所は %LOCALAPPDATA%\VMware\Identity Manager Desktop\thinapp になります。

注: 共有キャッシュを指定すると、 Workspace ONE Access Desktop アプリケーションはこの共有キャッシュから ThinApp パッケージを自動的に削除しません。SHARED_CACHE=1 は Windows システムのすべてのユーザー アカウントが同じ場所を共有することを示すので、特定のユーザーに使用資格を付与しない場合も含めて、使用資格が付与されたユーザーがそれを使用できるように、パッケージは共有された場所に配置する必要があります。ユーザーに ThinApp パッケージの使用資格を付与しない場合、 Workspace ONE Access Desktop アプリケーションはそのユーザーに対するそのパッケージの登録を解除します。その Windows システムでの使用資格を付与されている他のユーザーは、引き続き ThinApp パッケージを使用できます。その Windows システムで ThinApp パッケージの使用資格を付与されているユーザー アカウントがない場合は、領域を解放するために共通キャッシュを手動で削除できます。キャッシュの場所の下には、それぞれの ThinApp パッケージのフォルダがあります。
CACHE_DIR フォルダまでのパス HTTP_DOWNLOAD または COPY_TO_LOCAL インストール モードが使用される場合に、ThinApp パッケージがローカルでキャッシュされる場所を設定します。この値は、ユーザーごとではなく、システムごとに設定されるため、%LOCALAPPDATA% などの環境変数を使用して、ユーザー固有の場所を選択する必要があります。即座に展開されるのを防ぐため、必ずコマンド ラインで % 文字をエスケープしてください。例:

CACHE_DIR=^%LOCALAPPDATA^%\cache

AUTO_TRY_HTTP 0 または 1

COPY_TO_LOCAL オプションを指定して Workspace ONE Access Desktop アプリケーションがインストールされ、Workspace ONE Access にアカウント ベースのアクセスが構成されている場合、AUTO_TRY_HTTP オプションは、最初のダウンロード試行が失敗した場合に、ユーザーに使用資格が付与されている ThinApp パッケージをクライアントが(HTTP_DOWNLOAD オプションと同様に)HTTP プロトコルを使用して自動的にダウンロードするかどうかを決定します。このオプションは、デフォルトで有効になっています。ダウンロードに自動的に HTTP プロトコルを使用しない場合は、このオプションの値を 0 に設定します。

重要: AUTO_TRY_HTTP オプションが動作するには、 Workspace ONE Access における ThinApp パッケージの統合をアカウント ベースのアクセス用に構成する必要があります。 ThinApp パッケージおよびネットワーク共有リポジトリのための Workspace ONE Access の要件を参照してください。
INSTALL_MODULES thinapp インストールするモジュールを指定するカンマ区切りリスト。現在利用できるのは thinapp モジュールだけです。
MIGRATE_ACTION 次のいずれかになります。

MOVE

COPY

NONE

古い Workspace for Windows アプリケーションがインストールされている場合、インストーラはデータと設定を古いアプリケーションから新しいアプリケーションに移行します。デフォルト値は MOVE です。

次の設定は、指定する値によって、移動、コピー、無視のいずれかが行われます。

[キャッシュされた ThinApp パッケージ]

ダウンロードされた ThinApp パッケージは、Workspace for Windows のキャッシュ (%LOCALAPPDATA%\VMware\Horizon ThinApp\PackageCache) から、新しいキャッシュの場所 (%LOCALAPPDATA%\VMware\Identity Manager Desktop\thinapp) にコピーされます。キャッシュ フォルダ内のフォルダ名は変更されます。

重要: インストール中に Workspace ONE Access に設定されたプロパティは、移行されたプロパティのどの値よりも優先されます。たとえば、Workspace for Windows の INSTALL_MODE が COPY_TO_LOCAL に設定された場合、Identity Manager Desktop のインストー中に /v INSTALL_MODE=HTTP_DOWNLOAD を指定すると、INSTALL_MODE は HTTP_DOWNLOAD に設定されます。

Workspace ONE Access Desktop コマンド ライン インストーラ オプションの使用

Workspace ONE Access インスタンスに https://identitymanagerFQDN の URL が指定され、Workspace ONE Access が ThinApp パッケージのネットワーク共有にアカウント ベースでアクセスするように構成され、これらのオプションを使用して Workspace ONE Access Desktop アプリケーションを Workspace ONE Access インスタンスの複数のデスクトップにサイレントでインストールする必要がある場合:

  • これらの Windows システムがドメインに参加することはないと予測できるので、ThinApp のインストール オプションを HTTP_DOWNLOAD に設定します。Workspace ONE Access は、ThinApp パッケージのネットワーク共有にアカウント ベースでアクセスするように適切に構成されます。
  • クライアントは、新しいパッケージや使用資格がないか Workspace ONE Access に対して 60 秒おきにチェックします。
次のコマンドを起動するスクリプトを作成します。
VMware-Identity-Manager-Desktop-n.n.n-nnnnnnn.exe /s
   /v/qn WORKSPACE_SERVER="https://identitymanagerFQDN" INSTALL_MODE=HTTP_DOWNLOAD POLLING_INTERVAL=60
ファイル名の n.n.n-nnnnnnn の部分は、ダウンロードした Workspace ONE Access Desktop インストーラの名前と一致するように置き換えます。