Finding in the Wild | Citrix Admins: Wie viele eurer PowerShell-Skripte verwenden noch Get-BrokerMachine?

Zuletzt aktualisiert:

Vermutlich mehr, als euch lieb ist.

Wer eine Citrix Virtual Apps and Desktops Umgebung schon etwas länger betreibt, kennt das Cmdlet:
Get-BrokerMachine

Es steckt in unzähligen:
👉 Health-Check-Skripten
👉 Monitoring-Lösungen
👉 Automatisierungen
👉 Reporting-Skripten
👉 Scheduled Tasks
👉 eigenen Admin-Tools

Mit CVAD 2507 LTSR hat Citrix Get-BrokerMachine allerdings als deprecated markiert.

Der vorgesehene Nachfolger lautet:
Get-BrokerMachineV2

Warum sollte mich das interessieren?
Deprecated bedeutet zunächst einmal nicht, dass das Cmdlet morgen nicht mehr funktioniert.

Und genau deshalb werden solche Änderungen gerne ignoriert.

Das Problem kommt meistens später.

Das nächste CVAD Upgrade wird durchgeführt, alles sieht gut aus – und irgendwann funktioniert ein zehn Jahre altes PowerShell-Skript plötzlich nicht mehr.

Dann beginnt die Suche:
„Was hat sich eigentlich geändert?“

Dabei stand die Antwort möglicherweise schon mehrere Releases vorher in der Deprecation List.

Jetzt ist der richtige Zeitpunkt zum Prüfen

Ich würde deshalb nicht warten, bis Citrix das Cmdlet tatsächlich entfernt.

Einmal durch die eigenen Citrix-Skripte suchen nach:
Get-BrokerMachine

und prüfen:
Kann ich das bereits auf Get-BrokerMachineV2 umstellen?

Besonders interessant sind dabei Skripte, die automatisiert laufen.

Denn ein interaktives Admin-Skript fällt relativ schnell auf.

Ein Scheduled Task, der seit Jahren jede Nacht Reports erzeugt oder Maschinenzustände verarbeitet?

Der kann auch mal einige Tage kaputt sein, bevor jemand merkt, dass etwas fehlt. 😎
Und es betrifft nicht nur Get-BrokerMachine

Auch andere ältere Citrix PowerShell-Funktionen werden schrittweise deprecated.
Ein weiteres Beispiel aus CVAD 2507 ist:
Repair-AcctADAccount

Deshalb gehört für mich zu einem Citrix Upgrade inzwischen nicht nur:
Supported OS → Hypervisor → SQL → VDA → StoreFront

sondern auch:
Welche eigenen Automatisierungen hängen eigentlich an der Citrix PowerShell API?

Meine Empfehlung
Vor dem nächsten CVAD-Upgrade:
👉 PowerShell-Repositories nach deprecated Cmdlets durchsuchen
👉 Scheduled Tasks kontrollieren
👉 Monitoring- und Health-Check-Skripte berücksichtigen
👉 eigene Admin-Tools nicht vergessen
👉 Ersatz-Cmdlets im Lab testen

Alte Automatisierungen haben eine unangenehme Eigenschaft:
Sie funktionieren jahrelang hervorragend – bis zu dem Tag, an dem sie es nicht mehr tun.

Und dann natürlich meistens während eines Upgrades.

Autor: Manuel Winkel

Manuel Winkel ist IT-Consultant bei der Deyda Consulting GmbH mit Schwerpunkt auf Citrix, NetScaler ADC, Microsoft-Infrastrukturen und IT-Sicherheit. In seinen Beiträgen vermittelt er praxiserprobte Lösungen, technische Hintergründe und konkrete Handlungsempfehlungen für den sicheren und zuverlässigen Betrieb moderner IT-Umgebungen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert