リモートユーザーが公開済みのアプリケーションまたはデスクトップを起動すると、ホストサーバーで Parallels RAS によってセッション変数のセットが作成されます。この変数にはクライアントマシンについての情報が含まれます。この内容は必要に応じて調べることができます。変数は常に更新されるため、接続時または切断時に常に最新の値が含まれます。

次の RAS セッション変数を利用できます。

次の 2 つの方法のうちのいずれかを使用して、RAS セッション変数とその値を表示できます。

• ホストサーバーの Windows レジストリを調べる。

• GetRASVariable.exe ユーティリティ（Parallels RAS が提供している）を実行する。

各方法は以下のとおりです。

レジストリを調べる

変数を表示するには、regedit を実行し、HKEY_CURRENT_USER\Software\Parallels\Shell\<Session-ID> に移動します。ここで、<Session-ID> は RAS コンソールに表示されているセッションの ID です（たとえば、2、3、4 など）。特定のセッションの変数は、セッション ID ノードの下のリストに表示されます。接続時または切断時に、実際のクライアント構成を反映するために更新されます。変数はセッションの期間中は存在し、セッションが終了するとレジストリから削除されます。

上述の表に示す変数に加えて、セッション ID の下に（文書化されていない）他の変数が表示されることがあります。これらは Parallels RAS 内部での使用のみを目的としているため、無視してください。

GetRASVariable.exe ユーティリティの使用

GetRASVariable.exe ユーティリティは、Parallels RAS インストールフォルダー（C:\Program Files (x86)\Parallels\ApplicationServer など）にあります。変数の値を取得するには、パラメーターとして変数名を渡してコマンドラインからユーティリティを実行します（上述の表を参照してください）。このユーティリティは値を画面に出力します。

次の例に TUX_REMOTECLIENT_MACHINE 変数の値を示します。

GetRASVariable.exe TUX_REMOTECLIENT_MACHINE

通知ハンドラーを構成するには、次の操作を実行します。

1. RAS Console で、[ファーム] > [サイト] > [設定] に移動します。

2. [通知] タブを選択します。

3. [タスク] > [新規] をクリック（またはプラス記号アイコンをクリック）して、ハンドラーを作成するイベントを選択します。イベントとその説明のリストについては、下の**「システムイベント」**サブセクションを参照してください。

4. イベントハンドラーの設定を指定できるダイアログが開きます。

   [一般] タブで、次のオプションを指定します。

   • しきい値（数字または割合）。一部のイベント（ライセンス、Agent、およびその他のイベント）には、使用できません。

   • 方向（値が指定された値を超えたとき、または下回ったときのどちらでイベントがトリガーするか）。一部のイベント（上記と同じ）には、使用できません。

   • 管理者に電子メールで通知するかどうか。

   • イベントメッセージを送信する追加の電子メールアドレスです（コンマまたはセミコロンで区切る）。

   • イベントがトリガーしたとき、スクリプトを実行するかどうか。ここでは、[通知スクリプトを実行] オプションを選択し、ドロップダウンリストからスクリプトを選択する必要があります。このオプションを使用する前に、[通知スクリプトの構成] の説明に従って、1 つまたは複数のスクリプトを作成する必要があります。

   [条件] タブで、以下を指定します。

   • タイプ: 通知のトリガーとなるオブジェクトの種類を選択します。

   • サイト内の全サーバー: 利用可能なすべてのサーバーを含めるには、このオプションを選択します。

   • 使用可能容量: 通知のトリガーとなるオブジェクトを選択します。

   [設定] タブで、次を指定します。

   • デフォルト設定使用: デフォルト設定を使用する場合は、このオプションを選択します。デフォルトを編集するには、[デフォルトを編集] リンクをクリックします。カスタム設定を使用するには、このオプションをクリアし、下記のようにオプションを指定します。

   • 通知ハンドラー猶予期間: イベントの発生から通知がトリガーされるまで待機する時間（分）を指定します。トリガーしても、非常に短時間しか続かないイベントもあります。たとえば、CPU 使用率は、指定されたしきい値を超えて急激に跳ね上がる可能性がありますが、すぐに正常に戻ります。このようなイベントの場合、すぐに通知をトリガーしないのが理にかなっていると思われます。このオプションでは待機時間を指定できます。

   • 通知間隔: 前回の通知と次の通知の間の最短間隔（分）を指定します。管理者に複数の通知メールが立て続けに送信されないように（つまり、スパミングを回避）することができます。

   • 通知を 1 回送信した後、回復するまで通知の送信を停止: この設定が有効な場合、通知は一度のみ発生し、その後はその通知でモニターされている値が回復するまで停止されます。たとえば、CPU 使用率が 1 日中しきい値を超えている場合、通知ハンドラーを複数回実行するのではなく、RAS は一度のみ実行します。

5. 完了したら、[OK] をクリックして、通知ハンドラーを保存します。

送信メールが機能するように、RAS Console でメールボックスを構成してください。このメールボックスは、通常、初めて RAS Console を実行し、RAS 環境を設定するために [開始] カテゴリを使用するときに設定されます。「イベント通知を行うように SMTP サーバー接続を構成する」の説明にあるように、メールボックスを設定することもできます。

イベントハンドラーを有効または無効にするには、最初の列にあるチェックボックスを選択またはクリアするか、イベントを右クリックし、[有効] または [無効] を選択します。ハンドラーを変更するには、テンプレートを右クリックして [プロパティ] を選択します。ハンドラーを削除するには、右クリックして [削除] を選択します。

システムイベント

以下のシステムイベントに対応する通知ハンドラーを作成できます。

• CPU 使用率: CPU 使用率が指定された値を超えたとき、または下回ったときにトリガーします。

• メモリ使用率: メモリ使用率が指定された値を超えたとき、または下回ったときにトリガーします。

• RDSH セッションの数: アクティブなセッション数が指定された値を超えたとき、または下回ったときにトリガーします。

• 切断済み RDSH セッションの数: 切断済みセッションの数が指定された値を超えたとき、または下回ったときにトリガーします。

• RDSH セッション使用率: RDSH セッションの数が最大セッション数に対して指定された割合を超えたとき、または下回ったときにトリガーします。

• RDSH 切断済みセッション使用率: RDSH 切断済みセッション数が最大セッション数に対して指定された割合を超えたとき、または下回ったときに発生します。

• AVD セッション使用率: AVD セッションの数が最大セッション数に対して指定された割合を超えたとき、または下回ったときにトリガーします。

• AVD 切断済みセッション使用率: 切断済み AVD セッションの数が最大セッション数に対して指定された割合を超えたとき、または下回ったときにトリガーします。

• ゲートウェイでトンネリングされたセッション数: ゲートウェイでトンネリングされたセッション数が指定された値を超えたとき、または下回ったときに発生します。

• ゲートウェイでトンネリングされたセッションが失敗しました: ゲートウェイとリソースオブジェクト間の接続が確立できない場合に発生します。

• RAS Agent イベント: エージェントイベントが発生（たとえば、エージェントが切断または再接続）したときにトリガーします。

• ライセンスイベント: ライセンスイベントが発生したときにトリガーします。ここでの注目すべきイベントの 1 つが、ライセンスの使用数が定義済みのしきい値に達することです。具体的には、ライセンスの使用数が利用可能なすべてのライセンスの 90% に達すると、電子メールが送信され、ライセンス数は十分なのか、それとも追加する必要があるのかを決断することになります。他のイベントには、ライセンスのアクティベーション/デアクティベーション、ライセンスの失効、猶予期間の開始/終了、ライセンス情報の変更、ライセンスサーバーとの通信における問題などがあります。

• 認証サーバーイベント: 認証サーバーで接続に関する問題が発生したときにトリガーします。

• 公開済みアイテムイベント: 公開済みアイテムイベントが発生したとき（アプリケーションが同時実行可能インスタンス数の上限に達した場合など）にトリガーします。

• テンプレートイベント: VDI イベント（テンプレートが見つからないなど）が発生するとトリガーします。

• テナントイベント: テナントイベントが発生したときにトリガーを実行します。詳細については、「RAS マルチテナントアーキテクチャ」 > 「通知の構成」を参照してください。

「通知スクリプトの構成」セクションにある [通知タイプ] 表も参照してください。

[メールボックス] タブの [管理] カテゴリーでは、送信メール用の SMTP サーバーを構成できます。管理者がシステムイベントのアラート（前のセクションを参照）を受信し、ユーザーに招待メールを送信するには、SMTP サーバーが必要です。

SMTP サーバーを構成するには、次の手順に従います。

1. RAS コンソールで、[管理] カテゴリーを選択し、[メールボックス] タブをクリックします。

2. [メールサーバー] フィールドに、使用するメールサーバーの FDQN または IP アドレスを入力します。

3. [TLS / SSL] ドロップダウンリストで、プロトコルを使用するかどうかを選択します。

4. 必要に応じて [SMTP サーバーは認証をリクエストする] オプションを選択して、表示されるフィールドに SMTP サーバーユーザー名およびパスワードを入力します。

5. [送信者情報] セクションで、送信者のメールアドレス（お使いの電子メールなど）を入力します。

6. [テストメールボックス設定] セクションを使用して、SMTP サーバーの構成をテストできます。1 つ以上のメールアドレスをセミコロンで区切って入力します。[テストメール送信] をクリックして、設定をテストします。

[ファーム] > [サイト] > [設定] > [通知] タブで、システムイベント通知を構成できます。通知は、メールを介してシステムイベントについて管理者に知らせるために使用されます。通知を構成すると、その設定はファーム内のすべてのサーバーに適用されます。

通知を構成するには、最初にしきい値（利用可能な場合）や、管理者がメールを介して通知されるかどうかを指定できる、通知ハンドラーを構成する必要があります。イベントが発生したときに自動的に実行される通知スクリプトも構成できます。

Parallels RAS を使用して公開されたアプリケーションで z-order に関連する問題が発生した場合は、次の手順をお試しください。

1. Windows のレジストリを開きます。

2. HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Parallels\MemShell\ キーに EnableRemoteAppFixes という名前の値を DWORD タイプで作成します。

3. 問題に応じて、次のいずれかの値を指定します。

   • トレイアイコンが表示されない場合は、1 を指定します。

   • リサイズするまでダイアログが表示されている場合は、2 を指定します。

   • ダイアログが親アプリケーションに隠れてまったく表示されない場合は、4 を指定します。

Parallels RAS で問題が発生した場合は、RAS Console ですぐに解決策を検索できます。解決策を見つけられない場合は、Parallels にサポートリクエストを送信できます。このセクションでは、これらの作業をどのようにして行うかを説明します。

解決策を検索

RAS Console で解決策を検索するには、次の操作を実行します。

1. RAS Console のメインメニューで [ヘルプ] をクリックし、[トラブルシューティングおよびサポートのリクエスト] を選択します。

2. [トラブルシューティング] ダイアログが開きます。

3. [カテゴリーを選択] ドロップダウンリストで、発生している問題のカテゴリーを選択します。ダイアログの中央のエリアに、選択したカテゴリーに関連する KB 記事のリストが自動的に読み込まれます。

4. 興味のある記事をクリックして、ウェブブラウザーでお読みください。

5. [ナレッジベースインデックス] リンクまたは [フォーラム] リンクをクリックして、Parallels のナレッジベースまたは Parallels のフォーラムに移動することもできます。

サポートリクエスト

上述のオプションを使用して問題の解決策を見つけられない場合は、Parallels にサポートリクエストを送信できます。そうすると、収集したロギング情報が取得されてメールに添付されるため、Parallels Support で分析することができます。詳細については、ロギングを参照してください。

サポートリクエストを送信する前に、RAS Console 内にメールボックスが設定されていることを確認してください。メールボックスを設定していない場合は、次の手順に従って設定してください。

1. RAS Console で [管理] > [メールボックス] に移動します。

2. 送信メールサーバーの情報、メールアドレス、また、必要に応じてセキュリティ/認証情報を入力してください。

3. テストメール用のフィールドにメールアドレスを入力して、[テストメール送信] をクリックすると、テストメールを送信できます。

Parallels にサポートリクエストを送信するには、次の操作を実行します。

1. [トラブルシューティング] ダイアログで、[サポートリクエストを送信] ボタンをクリックします。

2. [サポートに問い合わせ] ダイアログが開きます。

3. あなたのフルネームと企業名を入力してください。

4. 件名を入力してください。これは、Parallels サポートに送信されるメールの件名に使用されます。

5. [クエリーの入力] ボックスに、できるだけ詳細に問題を説明してください。

6. ファイルをメールに添付するには、[添付] フィールドを使用してください。ファイルを参照するには、[...] ボタンをクリックします。Parallels サポートが解決策を見つけるのに役立つ、画像やその他のファイルを添付することができます。ログファイルと Parallels RAS の設定は収集され、自動的にメールに添付されるため、ユーザーがこの操作を行う必要はありません。

7. ダイアログの一番下のドロップダウンリストで、メールを送信するか、収集されたデータを自動的に含む zip ファイルとして保存するかのどちらかを選択できます。

8. 前の手順で選択したアクションに応じて、[送信] をクリックしてメールを送信するか、[保存] をクリックしてローカルドライブ、またはネットワークフォルダーに zip ファイルを保存します。

レポートの送信

サポートリクエストチケットをすでにお持ちの場合は、（新しい）チケットを作成せずに、システムレポートのみを Parallels に送信してください。

レポートを送信するには、次の操作を実行します。

1. RAS Console のメインメニューで [ヘルプ] をクリックし、[システムレポートを Parallels にアップロード] を選択します。

2. ダイアログが開き、進行状況バーが表示されます。

3. システムレポートデータが収集されて Parallels に送信されると、メッセージボックスが表示され、レポート番号を確認できます。

4. [OK] をクリックして完了します。

ローカルサポートへの問い合わせ

root 管理者がローカルサポートポータルに URL を追加した場合、[ヘルプ] メニューの [サポートをリクエスト] オプションを使用して、そのポータルに移動できます。

通知スクリプトを構成するには、次の操作を実行します。

1. [通知] タブの [通知スクリプト] セクションで、[タスク] > [新規] をクリック（またはプラス記号アイコンをクリック）します。

2. ダイアログが開いたら、次のオプションを指定します。

   • スクリプト名: スクリプトのフレンドリ名を入力します。

   • コマンド: 実行するコマンド。

   • 引数: コマンドに渡すコマンドライン引数。引数は、定義済みの変数のいずれかにすることが可能で、これを Parallels RAS が自動的に実際の値と置き換えます。下記の**「コマンドライン変数」**の表を参照してください（ID 列にここで使用できる値が記載されています）。

   • 初回ディレクトリ: プロセスの現在のディレクトリへのフルパス。文字列は、UNC パスも指定できます。

   • ユーザー名]、パスワード: これらは、特定のユーザーアカウントでコマンドを実行する場合に指定できる、オプションのフィールドです。

3. 完了したら、[OK] をクリックして、通知スクリプト項目を保存します。

通知スクリプトを変更するには、通知スクリプトを右クリックして [プロパティ] を選択します。

スクリプトを削除するには、右クリックして [削除] を選択します。スクリプトが通知ハンドラーに使用される場合は、警告メッセージが表示されることに注意してください。削除を選択すると、そのスクリプトを使用するすべての通知ハンドラーからスクリプトの関連付けが削除され、影響を受けるすべてのハンドラーが電子メールアラートを送信するように自動的に構成されます。

コマンドライン変数

以下の表は、スクリプトを実行するときに引数として使用できるコマンドライン変数の一覧です（上記の [引数] オプションの説明を参照してください）。

通知タイプ

以下の表はサポートされている通知タイプのリストです（ID 列は（$NOTIFICATION-TYPE）コマンドライン変数に渡される値を表します）。

Parallels RAS PowerShell を使用すると、Parallels RAS の管理タスクの大部分をコマンドラインから実行できます。

このセクションでは、PowerShell を使用したファーム設定のエクスポートおよびインポートについて説明します。Parallels RAS PowerShell の詳細については、https://www.parallels.com/products/ras/resources/ にアクセスして、「Parallels RAS PowerShell Guide」をダウンロード（またはオンラインで参照）してください。

ファーム設定のエクスポートおよびインポートの使用法の 1 つとして、自動化テストを実行できます。個別の設定を作成し、エクスポートした後、インポートすることで、特定のテストシナリオでその設定を使用できます。この機能を Windows タスクスケジューラーと併用して、ファーム設定の定期的なバックアップを行うこともできます。

Parallels RAS PowerShell のインストール

Parallels RAS のデフォルトインストールを実行すると、RAS PowerShell はデフォルトでインストールされます。RAS PowerShell をまだインストールしていない場合は（または、別のコンピューターにインストールしている場合は）、次の操作を実行します。

1. Parallels RAS インストーラーを実行します。

2. [カスタム] を選択し、[Parallels RAS PowerShell] コンポーネントを選択します。

3. ウィザードを実行し、Parallels RAS PowerShell をインストールします。

Parallels RAS PowerShell の使用

Parallels RAS PowerShell の最新情報はすべて、「Parallels RAS PowerShell Guide」で確認できます。このガイドには、「スタートアップ」の章が含まれ、Parallels RAS PowerShell を手軽に始めるために役に立つだけでなく、完全なリファレンスおよびコードサンプルとしても利用できます。このガイドを参照またはダウンロードするには、https://www.parallels.com/products/ras/resources/ にアクセスしてください。

以下の手順に従って、Parallels RAS ファーム設定をエクスポートおよびインポートします。

Parallels RAS PowerShell モジュールをインポートするには、PowerShell コンソールを開き、次のコマンドを実行します。

Import-Module PSAdmin

Parallels RAS セッションを作成します（Parallels RAS をインストールしたサーバーの名前または IP アドレスを使用します）。

New-RASSession -Server "server.company.dom"

ファーム設定をエクスポートするには、次のコマンドを実行します（バックアップファイルのパスおよびファイル名を独自の値で置き換えます）。

Invoke-RASExportSettings "C:\Backup\RAS-backup.dat2"

ファーム設定をインポートするには、次のコマンドを実行します。

Invoke-RASImportSettings "C:\Backup\RAS-backup.dat2"

Parallels RAS の新機能について何かアイデアがありましたら、ぜひご意見をお聞かせください。機能を推薦したい場合は、RAS Console でメインメニューの [ヘルプ] をクリックして、[お勧めの機能] を選択します。これにより、[Parallels RAS のお勧めの機能] に移動し、ご意見やアイデアをお知らせいただくことができます。お勧めの機能フォーラムに投稿するには、Parallels アカウントのメールアドレスおよびパスワードを使ってサインインする必要があります。

Parallels RAS を最新状態に保つ

デフォルトでは、Parallels RAS は、RAS Console が起動されるたびにアップデートがないかどうかを確認します。この動作を変更したい場合、次の操作を実行します。

1. [管理] カテゴリーを選択し、[設定] タブをクリックします。

2. ニーズに合わせて、[Parallels RAS Console の立上げ時にアップデートをチェックする] オプションを選択するか消去します。

3. 必要に応じて、[RAS RD セッションホスト Agent を自動でアップデート] オプションを選択するか消去します。

4. アップデートがないかどうかを手動で確認するには、[すぐにチェック] ボタンをクリックします。

Parallels RAS ファーム構成のバックアップ

Parallels RAS のファーム構成をバックアップするには、次の操作を実行します。

1. [管理] カテゴリーを選択し、[設定] タブをクリックします。

2. [エクスポート設定] ボタンをクリックします。

3. すべてのサイトを同期することを通知するメッセージが表示されます。エクスポートを続行するには [はい] をクリックし、中止するには [いいえ] をクリックします。

4. ファイル名とエクスポート先のフォルダーを指定し、[保存] をクリックします。

注: エクスポート手順では Parallels RAS ファームの構成データをエクスポートするだけです。ダウンロードされた OS など、関連のないオブジェクトはエクスポートファイルに含まれません。

Parallels RAS ファームの構成をバックアップファイルから復元するには、[インポート設定] ボタンをクリックして、バックアップファイル（デフォルトのファイル拡張子は .dat2 です）を選択します。ファイルから構成をインポートすると、既存のファーム構成はインポートされた構成に完全に置換されます。

Parallels RAS ファームの構成をコマンドラインからエクスポートおよびインポートすることも可能です。詳細な手順については、これから詳しく説明します。

Parallels RAS コンポーネントはモニタリングされており、関連情報を含むログが作成されます。ログは、Parallels RAS サポートエンジニアが、Parallels RAS インストールで起こる可能性のある問題を分析するために使用します。Parallels RAS 管理者は、特定のコンポーネントまたは複数のコンポーネント向けにログレベルを設定することができます。デフォルトでは標準のログレベルが使用されます。このログレベルでは、重要な情報のみが収集されて保存されます。Parallels RAS サポートエンジニアが、問題を分析するために追加情報が必要なときに、拡張ログレベルまたは詳細ログレベルの有効をユーザーに依頼することがあります。

特定のコンポーネントまたはサーバーのログレベルを設定するには、そのタイプのコンポーネント（RD セッションホスト、VDI、ゲートウェイ、Connection Broker など）が表示されている RAS Console のページに移動し、コンポーネントを選択して、[タスク] （または右クリック） > [トラブルシューティング] > [ロギング] > [構成] をクリックします。[ログレベルを設定] ダイアログが開きます。このダイアログで、次の選択肢からログレベルを選択できます。

• 標準 - 最も重要なイベントのみを記録する標準のログレベルです。後述のいずれかのログレベルを使用するように Parallels RAS サポートから指定された場合以外は、常にこのレベルを使用してください。

• 拡張 - このログレベルでは、標準ロギングよりも多くの情報が含まれます。ただし、収集する必要のある情報が増加するため、システムの速度が低下します。

• 詳細 - 詳細ロギングには拡張ロギングよりも多くの情報が含まれるため、システムの速度が大幅に低下する可能性があります。

パフォーマンスの低下を回避するには、拡張ロギングと詳細ロギングを（分析のために必要な情報を収集する上で十分な）限定的な期間のみ有効にする必要があります。この期間は [後で標準レベルにリセット] オプションを使用して設定できます。デフォルト値は 12 時間です。場合によっては、Parallels サポートエンジニアが、この期間に別の値を設定するようにアドバイスします。この期間が終了すると、ログレベルがリセットされて標準に戻ります。

ログファイルが格納されている ZIP アーカイブを取得するには、[タスク] （または右クリック） > [トラブルシューティング] > [ロギング] > [取得] をクリックし、ファイルを保存する場所を指定します。同じコンテキストメニュー内の [クリア] 項目で、すべてのログがクリアされます。

ログレベルは、[ファーム] > <サイト> > [設定] / [グローバルロギング] タブでも設定できます。ここでは、すべてのタイプの RAS コンポーネントを 1 つのリストに表示できます。詳細については、「サイト設定」を参照してください。

ログローテーション

Parallels RAS ログローテーションは次のように動作します。

1. すべてのログファイルの合計サイズが、定義済みのサイズ（デフォルトは 200 MB）に到達すると、ログがアーカイブされます。アーカイブは、ファイル名の末尾に現在のタイムスタンプを追加し、新しい空のログファイルの使用を開始することで、ログ別に実行されます。

2. 古いログに %logname%_%DATE%.zip という名前が付けられるたびに、新しい ZIP ファイルが作成されます（console_10.06.2018.zip、controller_10.06.2018.zip など）。

3. 名前が変更された古いログは、ZIP ファイルに移動されます。Parallels RAS では、デフォルトで 5 個の ZIP ファイルが保管されます。

4. アーカイブ済みのファイル数の上限を超えると、最も古いファイルが削除されます。

5. このログローテーションの仕組みによって、ログファイルサイズの合計が X * Y * Z MB を決して超えないように保証されています。ここで、X は各ログファイルの合計サイズ（デフォルトは 200 MB）、Y は ZIP ファイル数の上限（デフォルトは 5）、Z は RAS コンポーネントの数です。

6. 上述の例の X と Y の値は、該当の RAS コンポーネントをホストするコンピューター上の Windows レジストリに事前に定義されています。すべての RAS コンポーネントのデフォルト値は同じです。値を変更するには、HKEY_LOCAL_MACHINE > SOFTWARE > Wow6432Node > Parallels に移動して、RAS コンポーネントの LogMaxSize と LogMaxBackups の値を設定します。値を変更した後、サービスを再起動する。