Omnissa Horizon Advisor

Horizon Advisor ist ein auf PowerShell basierendes Verwaltungstool für Omnissa Horizon-Umgebungen. Verwenden Sie dieses Tool, um Ihre Umgebung vor der Installation oder dem Upgrade von Horizon Servern zu validieren, AD LDS-Wartungsarbeiten durchzuführen und Secure Gateway-Dienste zu verwalten – alles über eine interaktive Konsolenschnittstelle.

Voraussetzungen

Anforderungstabelle

Hinweis: Horizon Advisor muss direkt auf dem System ausgeführt werden, auf dem die Vorabprüfung durchgeführt werden muss.

Starten des Tools

Öffnen Sie eine PowerShell-Konsole und navigieren Sie zu dem Ordner, in den Horizon Advisor extrahiert wurde.
Führen Sie dann Folgendes aus:

.\Start-HorizonAdvisor.ps1

Dadurch wird das interaktive Hauptmenü geöffnet.

Wichtig: Bei jedem Ausführen von Start-HorizonAdvisor.ps1 werden zuvor akzeptierte TLS-Zertifikate gelöscht. Sie werden bei jedem neuen Ausführen erneut aufgefordert, alle nicht vertrauenswürdigen oder selbstsignierten Zertifikate zu akzeptieren.

Überblick über das Hauptmenü

Nach dem Start wird Ihnen das folgende Menü angezeigt:

================================================================
            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

Wählen Sie eine nummerierte Option aus und drücken Sie die Eingabetaste.

Vorabprüfungsvorgänge

Bei der Vorabprüfung wird Ihre Umgebung anhand der von Omnissa veröffentlichten Anforderungen für eine Horizon-Zielversion validiert. Sie überprüft Active Directory-Einstellungen, vCenter-Verbindungen, Servervoraussetzungen und LDAP/API-Konnektivität und erstellt dann einen detaillierten HTML-Bericht und optional einen PDF-Bericht.

Validierungstypen

Wenn Sie Vorabprüfungsvorgänge auswählen, werden Ihnen die folgenden Optionen angezeigt:

Hinweis: LDAP-Anforderungen können nur auf Horizon Server 2412 und höher überprüft werden.

Interaktives Ausführen von Validierungen

Nachdem Sie einen Validierungstyp ausgewählt haben, werden Sie vom Tool aufgefordert, die erforderlichen Eingaben vorzunehmen:

Active Directory-Validierung

• Active Directory-FQDN (z. B. dc.corp.example.com)
• Horizon-Zielversion (z. B. 2503)

vCenter-Validierung

• vCenter-FQDN (z. B. vcenter.corp.example.com)
• vCenter-Version (z. B. 8.0.2)
• Horizon-Zielversion

Servervalidierung

• Horizon-Zielversion

LDAP-Validierung

• Horizon Administrator-Benutzername
• Horizon-Domäne
• Horizon Administrator-Kennwort (sicher eingegeben – Eingabe ist verborgen)

Alle Validierungen ausführen

• Alle oben genannten Eingaben werden vor Beginn der Ausführung erfasst.

TLS-Zertifikat-Aufforderung

Für LDAP- und API-Validierungen stellt Horizon Advisor über HTTPS eine Verbindung mit dem Horizon Connection Server her. Wenn der Server ein selbstsigniertes oder nicht vertrauenswürdiges TLS-Zertifikat verwendet, wird die folgende Eingabeaufforderung angezeigt:

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):

Drücken Sie zum Akzeptieren und Fortfahren auf 1. Das Zertifikat wird nur für die Dauer dieser Ausführung als vertrauenswürdig eingestuft.

Drücken Sie zum Ablehnen auf 2. Die Verbindung wird abgebrochen und die Validierung wird nicht fortgesetzt.

Diese Eingabeaufforderung wird bei jeder Ausführung angezeigt. Akzeptierte Zertifikate werden niemals dauerhaft gespeichert.

Grundlegendes zu Berichten

Nach Abschluss einer Validierung wird automatisch ein HTML-Bericht (und ein PDF-Bericht, wenn ein unterstützter Browser verfügbar ist) generiert. Der Bericht enthält folgende Informationen:

Abschnitt „Zusammenfassung“

Detaillierte Ergebnistabelle

Die Zeilenfarben im Bericht entsprechen dem Status:

• Grün: BESTANDEN
• Gelb/Orange: WARNUNG
• Rot: FEHLGESCHLAGEN
• Blau: ÜBERSPRUNGEN

Bei Elementen, die mit FEHLGESCHLAGEN oder WARNUNG gekennzeichnet sind, überprüfen Sie immer die Spalte Empfohlen, um herauszufinden, welche Korrekturmaßnahme erforderlich ist, bevor Sie mit der Installation oder dem Upgrade von Horizon fortfahren.

Berichtsspeicherort

Berichte werden gespeichert unter:

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

Datei-Benennungskonventionen

Nachdem der Bericht generiert wurde, zeigt das Tool den vollständigen Pfad zu den HTML- und PDF-Dateien an. Sie können die HTML-Datei in einem beliebigen Webbrowser öffnen.

Wenn Microsoft Edge oder Google Chrome nicht installiert sind, wird die PDF-Datei nicht generiert. Der HTML-Bericht wird jedoch immer erstellt.

2. AD LDS-Vorgänge

Dieses Modul stellt Wartungsvorgänge für die Horizon AD LDS-Partition (Active Directory Lightweight Directory Services) auf dem Verbindungsserver bereit.

Verfügbare Vorgänge

Verwenden des Bereinigungsvorgangs

1. Wählen Sie die Option 2 im Menü „AD LDS-Vorgänge“ aus (oder führen Sie das Bereinigungsskript direkt aus).
   Das Tool zeigt den erkannten Horizon-Partitions-DN an.
   

2. Wählen Sie Ihre Vorgehensweise aus:

   • Option 1: Anzahl der veralteten Einträge anzeigen (keine Löschung) – sichere Vorschau
   • Option 2: Veralteter Einträge löschen – führt die eigentliche Bereinigung durch

3. Geben Sie den Schwellenwert für die Veraltung ein:

   • Geben Sie die Anzahl der Monate an, nach denen Daten als veraltet gelten sollen
   • Drücken Sie die Eingabetaste, um den Standardwert von 3 Monaten zu übernehmen
   • Nur Daten, die nicht innerhalb dieses Zeitraums geändert wurden, sind betroffen

4. Überprüfen Sie die Anzahl der veralteten Einträge:

   • Das Tool scannt AD LDS und zeigt die Anzahl der gefundenen veralteten Objekte an
   • Bei Auswahl von Option 1 wird der Vorgang hier ohne Löschvorgänge abgeschlossen

5. Bestätigen Sie den Löschvorgang (nur Option 2):

   • Überprüfen Sie die Anzahl der zu löschenden Einträge
   • Geben Sie 1 ein, um den Löschvorgang zu bestätigen.
   • Geben Sie einen anderen Wert ein oder drücken Sie die ESC-Taste, um den Vorgang abzubrechen.

6. Löschvorgang:

   • Das Tool löscht übereinstimmende Objekte in Batches (2.000 pro Batches).
   • Der Fortschritt wird nach jedem Batch gemeldet:

7. Abgeschlossen:

   • Die Gesamtanzahl der gelöschten Objekte wird angezeigt

   • Der Löschbericht enthält folgende Angaben:

     • Gelöschte Objekte insgesamt
     • Status des Bereinigungsabschlusses

Achtung: Durch diesen Vorgang werden die Benutzereinstellungsdaten dauerhaft aus AD LDS gelöscht. Gehen Sie folgendermaßen vor, bevor Sie mit dem Löschen fortfahren:

• Stellen Sie sicher, dass eine Sicherung Ihrer AD LDS-Datenbank vorhanden ist
• Bestätigen Sie gemeinsam mit Ihrem Team, dass alte Einstellungen sicher entfernt werden können
• Führen Sie Option 1 zuerst in der Vorschau aus
• Führen Sie den Vorgang vorzugsweise während eines Wartungsfensters mit geringer Benutzeraktivität aus

Secure Gateway-Dienst verwalten

Dieses Modul aktiviert bzw. deaktiviert die Dienste PCoIP Secure Gateway und BLAST Secure Gateway auf einem Horizon Connection Server.

Verfügbare Vorgänge

Secure Gateway Management muss direkt auf dem Horizon Connection Server ausgeführt werden, auf dem die Gateway-Dienste installiert sind. Das Tool überprüft vor dem Fortfahren, ob eine Horizon Connection Server-Installation erkannt wurde.

Befehlszeilenmodus (nicht interaktiv)

Horizon Advisor unterstützt die nicht interaktive Ausführung für die Verwendung in Skripts oder Automatisierungs-Pipelines. Übertragen Sie Parameter direkt über die Befehlszeile an Start-HorizonAdvisor.ps1.

Syntax

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

Parameter

Beispiele

Servervalidierung ausführen:

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

Active Directory-Validierung ausführen:

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

vCenter-Validierung ausführen:

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

LDAP-Validierung ausführen – sichere Kennwortabfrage bei Laufzeit:

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

LDAP-Validierung ausführen und ein selbstsigniertes Zertifikat akzeptieren ohne Eingabeaufforderung:

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

Alle Validierungen ausführen – sichere Kennwortabfrage bei Laufzeit:

.\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'

Kennwortbehandlung für automatisierte/skriptbasierte Ausführungen

Wenn Sie Horizon Advisor als Teil einer geplanten Aufgabe oder Automatisierungs-Pipeline ausführen, bei der keine interaktive Eingabeaufforderung möglich ist, müssen Sie das Kennwort im Voraus mithilfe des -HorizonAdminPassword-Parameters als PowerShell SecureStringangeben.

Die Art und Weise, wie Sie SecureString bereitstellen, richtet sich nach den Sicherheitspraktiken Ihres Unternehmens, z. B. über einen Secrets Manager, einen Anmeldedatentresor, eine verschlüsselte Datei oder eine andere Methode. Die einzige Anforderung besteht darin, dass der an übergebene -HorizonAdminPassword Wert ein SecureString sein muss.

Beispiel: Übergeben eines SecureString für die automatisierte Ausführung:

# 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

Abrufen von Hilfe

So zeigen Sie die Befehlszeilenverwendung und Beispiele direkt aus der Konsole heraus an:

.\Start-HorizonAdvisor.ps1 -Help