エンドユーザーがクリックして Horizon Client を起動したり、リモート デスクトップまたは公開アプリケーションを開くことができるように、URI (Uniform resource identifier) を使用して Web ページのリンクまたは E メールのリンクを作成できます。
部分的または以下のすべての情報を提供する URI を構築してこれらのリンクを作成すれば、エンド ユーザーは入力する必要がありません。
- サーバ アドレス
- サーバのポート番号
- Active Directory ユーザー名
- Active Directory ユーザー名と異なる場合、RADIUS または RSA SecurID ユーザー名
- ドメイン名
- リモート デスクトップまたは公開アプリケーションの表示名
- ウィンドウ サイズ
- セッションのリセット、ログアウト、開始を含むアクション
-
- 表示プロトコル
- USB デバイスをリダイレクトするオプション
URI を作成するには、Horizon Client 固有のパスとクエリ部分と共に vmware-view URI スキーマを使用します。
URI を使用して Horizon Clientを起動するには、クライアント コンピュータに Horizon Clientがインストールされている必要があります。
vmware-view URI を作成するための構文
URI 構文には、vmware-view URI スキーム、リモート デスクトップや公開アプリケーションを指定するためのパス部分、オプションでリモート デスクトップや公開アプリケーションのアクション、または構成オプションを指定するためのクエリが含まれます。
URI 仕様
以下の構文を使用して Horizon Client を起動するための URI を作成します。
vmware-view://[authority-part][/path-part][?query-part]
必要となる唯一の要素は URI スキーム vmware-view です。クライアント オペレーティング システムのバージョンによっては、スキーム名で大文字と小文字が区別されるため、vmware-view と入力してください。
ASCII 文字のエンコードについての詳細は、「http://www.utf8-chartable.de/」の URL エンコーディング資料を参照してください。
- authority-part
-
サーバ アドレス。オプションでユーザー名、デフォルト以外のポート番号、またはその両方。サーバ名ではアンダースコア (_) はサポートされません。サーバ名は、DNS 構文に一致する必要があります。
ユーザー名を指定するには、以下の構文を使用します。
user1@server-address
ドメインが含まれる UPN アドレスを指定できません。ドメインを指定するには、URI で domainName クエリ部分を使用できます。
ポート番号を指定するには、以下の構文を使用します。
server-address:port-number
- path-part
- リモート デスクトップまたは公開アプリケーションの表示名。表示名は、デスクトップ プールまたはアプリケーション プールの作成時に、Horizon Console で指定します。表示名にスペースが含まれている場合、 %20 エンコーディングを使用してスペースを表します。
- query-part
-
使用する構成オプション。あるいは、リモート デスクトップまたは公開アプリケーションで実行するアクション。クエリは大文字と小文字の区別がありません。複数のクエリを使用するには、クエリの間にアンパサンド (&) を使用します。クエリが競合する場合、
Horizon Client はリストの最後にあるクエリを使用します。次の構文を使用します。
query1=value1[&query2=value2...]
サポートされるクエリ
このタイプの Horizon Client では、次のクエリがサポートされます。デスクトップ クライアントやモバイル クライアントなど、複数のタイプのクライアントに URI を作成する場合は、対応するクライアント システムのガイド ドキュメントを参照して、サポートされるクエリを確認してください。
- 操作
-
表 1. アクション クエリで使用できる値 値 説明 browse 指定したサーバにホストされている使用可能なリモート デスクトップおよび公開アプリケーションのリストを表示します。このアクションを使用しているときに、リモート デスクトップまたは公開アプリケーションを指定する必要はありません。 start-session 指定されたリモート デスクトップまたは公開アプリケーションを開きます。アクション クエリが提供されず、リモート デスクトップまたは公開アプリケーション名が提供されなければ、start-sessionがデフォルト アクションとなります。 reset 指定したリモート デスクトップまたは公開アプリケーションをシャットダウンして再起動します。保存されてないデータは失われます。リモート デスクトップのリセットは、物理 PC のリセット ボタンを押すことと同じです。 restart 指定したリモート デスクトップをシャットダウンして再起動します。リモート デスクトップの再起動は、Windows オペレーティング システムを再起動するコマンドと同じです。オペレーティング システムでは、通常、ユーザーは再起動する前に未保存データを保存するよう求められます。 logoff リモート デスクトップのゲスト OS からユーザーをログオフします。公開アプリケーションを指定すると、アクションは無視されるか、エンド ユーザーに警告メッセージ「無効な URI アクション」が表示されます。 - args
-
公開アプリケーションの起動時に追加するコマンドライン引数を指定します。
args=
値 の構文を使用します。
値 には文字列を指定します。次の文字についてはパーセント エンコーディングを使用します。
- コロン (:) には、%3A を使用します
- バック スラッシュ (\) には、%5C を使用します
- スペース ( ) には、%20 を使用します
- 二重引用符 (") には、%22 を使用します
たとえば、Notepad++ アプリケーションに "My new file.txt" というファイル名を指定するには、%22My%20new%20file.txt%22 を使用します。
- appProtocol
- 公開アプリケーションの場合、有効な値は PCOIP と BLAST です。たとえば、PCoIP を指定するには、 appProtocol=PCOIP 構文を使用します。
- connectUSBOnInsert
- USB デバイスを物理的に接続したときに、そのデバイスをフォアグラウンド リモート デスクトップまたは公開アプリケーションに接続します。リモート デスクトップに unattended クエリを指定すると、このクエリが暗黙的に設定されます。このクエリを使用するには、 action クエリを start-session に設定する必要があります。さもないと、 action クエリを持ちません。有効な値は、 true および false です。構文の例は、 connectUSBOnInsert=true です。
- connectUSBOnStartup
- クライアント システムに現在接続されているすべての USB デバイスをリモート デスクトップまたは公開アプリケーションにリダイレクトします。リモート デスクトップに unattended クエリを指定すると、このクエリが暗黙的に設定されます。このクエリを使用するには、 action クエリを start-session に設定する必要があります。さもないと、 action クエリを持ちません。有効な値は、 true および false です。構文の例は、 connectUSBOnStartup=true です。
- desktopLayout
-
リモート デスクトップのウィンドウ サイズを設定します。このクエリを使用するには、
action クエリを
start-session に設定する必要があります。そうしないと、
action クエリを使用できません。
表 2. desktopLayout クエリの有効値 値 説明 fullscreen 1 台のモニターで全画面表示。この値がデフォルトになります。 multimonitor すべてのモニターで全画面表示。 windowLarge 大きなウィンドウ。 windowSmall 小さなウィンドウ。 WxH カスタム解像度で、幅と高さをピクセルで指定します。構文の例は、desktopLayout=1280x800 です。 - desktopProtocol
- リモート デスクトップの場合、有効な値は RDP、 PCOIP、および BLAST です。たとえば、PCoIP を指定するには、 desktopProtocol=PCOIP 構文を使用します。
- domainName
- リモート デスクトップや公開アプリケーションに接続しているユーザーに関連付けられている NETBIOS ドメイン名を指定します。例として、 mycompany.com ではなく mycompany を使用してください。
- filePath
-
公開アプリケーションで開くローカル システムにあるファイルへのパスを指定します。ドライブ文字を含む絶対パスを指定する必要があります。次の文字についてはパーセント エンコーディングを使用します。
- コロン (:) には、%3A を使用します
- バック スラッシュ (\) には、%5C を使用します
- スペース ( ) には、%20 を使用します
たとえば、ファイル パス C:\test file.txt を表記するには、C%3A%5Ctest%20file.txt を使用します。
- launchMinimized
- Horizon Client を最小化モードで起動します。リモート デスクトップまたは公開アプリケーションが開始するまで、 Horizon Client は最小化された状態のままになります。構文は、 launchMinimized=true です。このオプションは、 [unattended] クエリと一緒に使用できません。
- tokenUserName
- RSA または RADIUS ユーザー名を指定します。RSA または RADIUS ユーザー名が Active Directory ユーザー名と異なる場合にのみこのクエリを使用します。このクエリを指定せず、RSA または RADIUS 認証が必要である場合、 Horizon Client は Windows ユーザー名を使用します。この構文は、 tokenUserName=name です。
- unattended
- リモート デスクトップへのサーバ接続をキオスク モードで作成します。このクエリを使用する場合に、クライアント デバイスの MAC アドレスからアカウント名を生成したときには、ユーザー情報を指定しないでください。「custom-」で始まる名前など、カスタム アカウント名を ADAM で作成した場合、アカウント情報を指定する必要があります。
- useExisting
- このオプションが true に設定されている場合、実行できる Horizon Client インスタンスは 1 つのみです。ユーザーが 2 番目のサーバへの接続を試みる場合、ユーザーは 1 番目のサーバからログアウトし、リモート デスクトップおよび公開アプリケーションのセッションを切断する必要があります。このオプションが false に設定されている場合は、複数の Horizon Client インスタンスを実行でき、ユーザーが同時に複数のサーバに接続できます。デフォルトは true です。構文の例は、 useExisting=false です。
- unauthenticatedAccessEnabled
- このオプションが true に設定されている場合、非認証アクセス機能は、デフォルトで有効になります。 [非認証アクセス] オプションがユーザー インターフェイスに表示され選択されます。このオプションが false に設定されている場合、非認証アクセス機能は無効になります。 [非認証アクセス] 設定が表示されず、無効になります。このオプションが "" に設定されている場合、非認証アクセス機能は無効になります。 [非認証アクセス] 設定はユーザー インターフェイスに表示されず、無効になります。構文の例は、 unauthenticatedAccessEnabled=true です。
- unauthenticatedAccessAccount
- 非認証アクセス機能が有効になっている場合、使用するアカウントを設定します。非認証アクセス機能が無効な場合、このクエリは無視されます。 anonymous1 ユーザー アカウントを使用する場合、 unauthenticatedAccessAccount=anonymous1 のように構文を指定します。
vmware-view URI の例
vmware-view URI スキームを使用してハイパー テキスト リンクまたはボタンを作成し、これらのリンクを E メールまたは Web ページで使用できます。たとえば、エンドユーザーが URI リンクをクリックすると、指定した起動オプションでリモート デスクトップが起動します。
各 URI の例に続いて、URI リンクをクリック後にエンド ユーザーに表示される事項について説明します。
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログインのダイアログ ボックスが表示され、ユーザー名、ドメイン名、パスワードの入力が要求されます。ログインに成功すると、表示名が Primary Desktop のリモート デスクトップにクライアントが接続します。ユーザーはゲスト OS にログインされます。
注: この例では、デフォルトの表示プロトコルとウィンドウ サイズが使用されます。デフォルトの表示プロトコルは PCoIP で、デフォルトのウィンドウ サイズは全画面表示です。 -
vmware-view://view.mycompany.com/cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログインのダイアログ ボックスが表示され、ユーザー名、ドメイン名、パスワードの入力が要求されます。ログインに成功すると、クライアントがデスクトップ ID CN=win7-32,OU=Applications,DC=vdi,DC=vmware,DC=int(エンコードされた値:cn%3Dwin7-32%2Cou%3Dapplications%2Cdc%3Dvdi%2Cdc%3Dvmware%2Cdc%3Dint)のリモート デスクトップに接続します。
-
vmware-view://view.mycompany.com:7555/Primary%20Desktop
この URI は前の例と同じ効果がありますが、Connection Server インスタンスに 7555 の非デフォルト ポートを使用するところが異なります。(デフォルトのポートは 443 です)。リモート デスクトップ ID が提供されるので、start-session アクションが URI に含まれていない場合であっても、リモート デスクトップが開きます。
-
vmware-view://[email protected]/Finance%20Desktop?desktopProtocol=PCOIP
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログイン ダイアログ ボックスで、[ユーザー名] テキスト ボックスに fred が挿入されます。ユーザーはドメイン名とパスワードを入力する必要があります。ログインに成功すると、表示名が Finance Desktop のリモート デスクトップにクライアントが接続します。ユーザーはゲスト OS にログインされます。PCoIP 表示プロトコルを使用して接続します。
-
vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
Horizon Client が起動し、view.mycompany.com サーバに接続します。ユーザーは、ログイン ダイアログ ボックスにユーザー名、ドメイン名、パスワードを入力する必要があります。ログインに成功すると、クライアントは Calculator という表示名の公開アプリケーションに接続します。VMware Blast 表示プロトコルを使用して接続します。
-
vmware-view://[email protected]/Finance%20Desktop?domainName=mycompany
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログイン ダイアログ ボックスで、[ユーザー名] テキスト ボックスに fred が挿入され、[ドメイン] テキスト ボックスに mycompany が挿入されます。ユーザーはパスワードを入力する必要があるだけです。ログインに成功すると、表示名が Finance Desktop のリモート デスクトップにクライアントが接続します。ユーザーはゲスト OS にログインされます。
-
vmware-view://view.mycompany.com/
Horizon Client が起動し、ユーザーは、view.mycompany.com サーバに接続するためにログインを求められます。
-
vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログインのダイアログ ボックスが表示され、ユーザー名、ドメイン名、パスワードの入力が要求されます。ログインに成功すると、Horizon Client は指定されたデスクトップをリセットします。
注: 管理者がリモート デスクトップのリセット機能を有効にしている場合にのみ、このアクションを実行できます。 -
vmware-view://view.mycompany.com/Primary%20Desktop?action=restart
Horizon Client が起動し、view.mycompany.com サーバに接続します。ログインのダイアログ ボックスが表示され、ユーザー名、ドメイン名、パスワードの入力が要求されます。ログインに成功すると、Horizon Client は指定されたデスクトップを再起動します。
注: 管理者がリモート デスクトップの再起動機能を有効にしている場合にのみ、このアクションを実行できます。 -
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session&connectUSBOnStartup=true
この URI は最初の例と同じ効果があり、クライアント システムに接続しているすべての USB デバイスは、リモート デスクトップにリダイレクトされます。 -
vmware-view://
Horizon Client が実行されていない場合、起動します。Horizon Client が実行されている場合、フォアグラウンドで実行されます。
-
vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
Notepad++ をサーバ 10.10.10.10 で起動して、引数 My new file.txt を公開アプリケーションの起動コマンドに渡します。スペース文字と二重引用符では、パーセントのエスケープ文字が使用されます。ファイル名にはスペース文字が含まれるため、二重引用符で囲まれています。
次の構文を使用して、Windows コマンド ライン プロンプトでこのコマンドを入力することもできます。vmware-view.exe --serverURL 10.10.10.10 --appName "My Notepad++" --args "\"my new.txt\""
この例では、二重引用符は、\" の文字を使用してエスケープされます。 -
vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
Notepad++ 12 をサーバ 10.10.10.10 で起動して、引数 a.text b.txt をアプリケーションの起動コマンドに渡します。引数は引用符で囲まれていないため、スペース文字によってファイル名が分割され、2 つのファイルが Notepad++ で別々に開きます。
注: 公開アプリケーションによって、コマンドラインの引数を使用する方法が異なる場合があります。たとえば、引数 a.txt b.txt をワードバッドに渡すと、ワードバッドは a.txt の 1 つのファイルのみを開きます。 -
vmware-view://view.mycompany.com/Notepad?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous1
Horizon Client が起動すると、anonymous1 というユーザー アカウントを使用して、view.mycompany.com サーバに接続します。Notepad アプリケーションは、ユーザーにログイン認証情報の指定を求めずに起動します。
HTML コードの例
URI を使用してハイパー リンクおよびボタンを作成し、E メールまたは Web ページに含めることができます。以下の例では、[Test Link(テスト リンク)] というラベルのハイパー リンクと [TestButton] というラベルのボタンのコードを記述するために、最初の URI のサンプルの URI を使用しています。
<html> <body> <a href="vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session">Test Link</a><br> <form><input type="button" value="TestButton" onClick="window.location.href= 'vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br> </body> </html>