Omnissa Horizon Advisor

Horizon Advisor は、Omnissa Horizon 環境向けの PowerShell ベースの管理ツールです。このツールを使用すると、Horizon Server のインストールまたはアップグレード前の環境の検証、Active Directory LDS のメンテナンス、Secure Gateway サービスの管理のすべてを 1 つのインタラクティブなコンソール インターフェイスから実行できます。

前提条件

要件表

**注：**事前チェックの実行が必要なシステムで Horizon Advisor を直接実行する必要があります。

ツールの起動

PowerShell コンソールを開き、Horizon Advisor が抽出されているフォルダに移動します。
次のコマンドを実行します。

.\Start-HorizonAdvisor.ps1

これにより、インタラクティブなメイン メニューが開きます。

重要：Start-HorizonAdvisor.ps1 を実行するたびに、以前に承認された TLS 証明書がクリアされます。新たに実行するたびに、信頼されていない証明書または自己署名証明書を受け入れるように求められます。

メイン メニューの概要

起動すると、次のメニューが表示されます。

================================================================
            Welcome to Omnissa Horizon Advisor
         Your Comprehensive Horizon Management Tool
================================================================
Main Menu - Please select an option:
  1. Pre-Check Operations for Horizon Server Install / Upgrade
  2. AD LDS Operations
  3. Manage Secure Gateway Service
  4. Exit

番号付きのオプションの一つを選択して、Enter を押します。

事前チェック操作

事前チェックでは、ターゲットの Horizon バージョンに対する Omnissa の公開要件を照合し、環境の検証を行います。Active Directory の設定、vCenter Server 接続、サーバの前提条件、LDAP/API 接続をチェックしてから、詳細な HTML レポートを作成します（オプションで PDF レポートを作成することもできます）。

検証タイプ

[事前チェック操作] を選択すると、次の選択肢が表示されます。

**注：**LDAP 要件の検証は、Horizon Server 2412 以降でのみ使用できます。

インタラクティブな検証の実行

検証タイプを選択すると、ツールで必要な入力を求めるプロンプトが表示されます。

Active Directory の検証

• Active Directory FQDN（dc.corp.example.com など）
• ターゲット Horizon のバージョン（2503 など）

vCenter Server の検証

• vCenter Server の FQDN（vcenter.corp.example.com など）
• vCenter Server のバージョン（8.0.2 など）
• ターゲット Horizon のバージョン

サーバ検証

• ターゲット Horizon のバージョン

LDAP 検証

• Horizon Administrator のユーザー名
• Horizon ドメイン
• Horizon Administrator のパスワード（安全に入力。入力は非表示）

すべての検証の実行

• 上記のすべての入力は、実行開始前に収集されます。

TLS 証明書プロンプト

LDAP および API の検証では、Horizon Advisor は HTTPS 経由で Horizon Connection Server に接続します。サーバが自己署名証明書または信頼できない TLS 証明書を使用している場合は、次のプロンプトが表示されます。

Untrusted TLS certificate detected for https://<server>/rest/...
Subject   : CN=<server>
Issuer    : CN=<server>
Thumbprint: XXXX...
Valid From: ...
Valid To  : ...
Certificate appears to be self-signed.
Press '1' to accept this certificate for this run only
Press '2' to reject and stop the request
Select an option (1-2):

承認して続行するには、1 と入力します。証明書は、この実行でのみ信頼されます。

拒否するには 2 を押します。接続は中止され、検証は続行されません。

このプロンプトは実行ごとに表示されます。承諾された証明書が永続的に保存されることはありません。

レポートについて

検証が完了すると、HTML レポート（サポートされているブラウザが使用可能な場合は PDF も）が自動的に生成されます。レポートには以下の内容が含まれます。

[サマリ] セクション

詳細な結果テーブル

レポートの行の色はステータスに対応しています。

• 緑：パス
• 黄色/オレンジ色：警告
• 赤：失敗
• 青：スキップ

FAIL または WARNING とマークされた項目については、Horizon のインストールまたはアップグレードを続行する前に、必ず [推奨] 列で必要な対策を確認してください。

レポートの場所

レポートは次の場所に保存されます。

%ProgramData%\Omnissa\Horizon\logs\HorizonAdvisor\PreCheckReports\

ファイルの命名規則

レポートが生成されると、HTML ファイルと PDF ファイルの両方のフル パスが表示されます。HTML ファイルは、任意の Web ブラウザで開くことができます。

Microsoft Edge または Google Chrome がインストールされていない場合、PDF は生成されませんが、HTML レポートは常に作成されます。

2. AD LDS 操作

このモジュールは、Connection Server の Horizon AD LDS（Active Directory ライトウェイト ディレクトリ サービス）パーティションのメンテナンス操作を提供します。

使用可能な操作

クリーンアップ操作の実行

1. AD LDS 操作メニューからオプション 2 を選択します（またはクリーンアップ スクリプトを直接実行します）。
   検出された Horizon パーティション DN が表示されます。
   

2. 操作を選択します。

   • オプション 1：古いエントリの数を表示 (削除はしない) - 安全なプレビュー
   • オプション 2：古いエントリを削除 - クリーンアップを実際に実行します

3. 古いしきい値の入力：

   • 古いデータと見なす経過月数を指定します
   • デフォルト値（3 か月）を使用するには、Enter キーを押します。
   • この期間内に変更されていないデータのみが対象となります。

4. 古いエントリ数を確認します。

   • このツールは AD LDS をスキャンし、見つかった古いオブジェクトの数を表示します。
   • オプション 1 を選択した場合、操作はここで完了します。削除は実行されません。

5. 削除の確認（オプション 2 のみ）：

   • 削除するエントリの数を確認します。
   • 1 と入力して削除を確認します。
   • 操作をキャンセルすには、その他の文字を入力するか、Esc キーを押します。

6. 削除プロセス：

   • 一致するオブジェクトがバッチ単位で削除されます（バッチあたり 2,000 個）。
   • 各バッチの後に進行状況が報告されます。

7. 完了：

   • 削除されたオブジェクトの合計数が表示されます。

   • 削除レポートには次の項目が表示されます。

     • 削除されたオブジェクトの合計数
     • クリーンアップの完了状況

**注意：**この操作を行うと、AD LDS からユーザー設定データが完全に削除されます。削除を続行する前に：

• AD LDS データベースのバックアップがあることを確認します。
• 古い設定を安全に削除できることをチームに確認します。
• まず、オプション 1 を実行してプレビューします。
• ユーザー アクティビティが最も少ないメンテナンス ウィンドウ中に実行することを検討してください。

Secure Gateway サービスの管理

このモジュールでは、Horizon Connection Server の PCoIP Secure Gateway サービスと BLAST Secure Gateway サービスを有効または無効にします。

使用可能な操作

Secure Gateway 管理は、ゲートウェイ サービスがインストールされている Horizon Connection Server で直接実行する必要があります。ツールは、続行する前に Horizon Connection Server がインストールされていることを検証します。

コマンドライン モード（非インタラクティブ）

Horizon Advisor は、スクリプトまたは自動化パイプラインで使用する非インタラクティブな実行をサポートします。コマンド ラインから Start-HorizonAdvisor.ps1 にパラメータを直接渡します。

構文

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation <type> -TargetHorizonVersion <version> [options]

パラメータ

例

サーバ検証の実行：

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation server -TargetHorizonVersion '2503'

Active Directory の検証の実行：

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation activedirectory -AdFqdn 'dc.corp.example.com' -TargetHorizonVersion '2503'

vCenter Server の検証：

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation vcenter -VCenterFqdn 'vcenter.corp.example.com' -VCenterVersion '8.0.2' -TargetHorizonVersion '2503'

LDAP 検証の実行 - ランタイムにパスワードがプロンプトで安全に表示されます。

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation ldap -HorizonAdminUsername 'admin' -HorizonDomain 'corp'

LDAP 検証を実行し、プロンプトを表示することなく、自己署名証明書を受け入れます。

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation ldap -HorizonAdminUsername 'admin' -HorizonDomain 'corp' -AcceptSelfSignedCertificate

すべての検証の実行 - ランタイムにパスワードがプロンプトで安全に表示されます。

.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation all -AdFqdn 'dc.corp.example.com' -VCenterFqdn 'vcenter.corp.example.com' -VCenterVersion '8.0.2' -TargetHorizonVersion '2503' -HorizonAdminUsername 'admin' -HorizonDomain 'corp'

自動実行またはスクリプト実行でのパスワード処理

インタラクティブなプロンプトが不可能なスケジュール設定タスクまたは自動化パイプラインの一部として Horizon Advisor を実行する場合は、PowerShell SecureStringとして -HorizonAdminPassword パラメータを使用し、パスワードを事前に指定する必要があります。

SecureString のプロビジョニング方法は、Secrets Manager、認証情報ボールト、暗号化されたファイル、その他の方法など、組織のセキュリティ プラクティスによって異なります。唯一の要件は、-HorizonAdminPassword に渡される値が SecureString であることです。

例：自動実行のための SecureString の受け渡し：

# Obtain a SecureString by whatever method suits your environment
$securePassword = <your SecureString here>
.\Start-HorizonAdvisor.ps1 -Flow precheck -Validation ldap `
    -HorizonAdminUsername 'admin' -HorizonDomain 'corp' `
    -HorizonAdminPassword $securePassword

ヘルプの表示

コマンド ラインの使用方法と例をコンソールから直接表示するには：

.\Start-HorizonAdvisor.ps1 -Help