Last updated:
Probably more than you would like.
Anyone who has operated Citrix Virtual Apps and Desktops for a while knows this cmdlet:
Get-BrokerMachine
It appears in countless:
👉 Health-check scripts
👉 Monitoring solutions
👉 Automations
👉 Reporting scripts
👉 Scheduled tasks
👉 Custom admin tools
With CVAD 2507 LTSR, Citrix marked Get-BrokerMachine as deprecated.
Its intended successor is:
Get-BrokerMachineV2
Why should I care?
Deprecated initially does not mean the cmdlet will stop working tomorrow.
That is exactly why such changes are often ignored.
The problem usually comes later.
The next CVAD upgrade is completed, everything looks good, and eventually a ten-year-old PowerShell script suddenly stops working.
Then the search begins:
What actually changed?
The answer may have been in the deprecation list several releases earlier.
Now is the right time to check
I would not wait until Citrix actually removes the cmdlet.
Search your Citrix scripts for:
Get-BrokerMachine
And check:
Can I already switch this to Get-BrokerMachineV2?
Scripts that run automatically are particularly interesting.
An interactive admin script tends to attract attention quickly.
But a scheduled task that has generated reports or processed machine states every night for years?
It can be broken for several days before anyone notices something is missing. 😎
It is not just Get-BrokerMachine
Other older Citrix PowerShell functions are also being gradually deprecated.
Another example from CVAD 2507 is:
Repair-AcctADAccount
For me, a Citrix upgrade now therefore includes more than:
Supported OS → hypervisor → SQL → VDA → StoreFront
It also includes:
Which custom automations depend on the Citrix PowerShell API?
My recommendation
Before the next CVAD upgrade:
👉 Search PowerShell repositories for deprecated cmdlets
👉 Check scheduled tasks
👉 Include monitoring and health-check scripts
👉 Do not forget custom admin tools
👉 Test replacement cmdlets in the lab
Old automations have an inconvenient characteristic:
They work brilliantly for years, until the day they do not.
Usually during an upgrade, of course.
