<< Back to Script Library

List all XenDesktop VMs in Maintenance Mode

This script will list all the VMs in a specific XenDesktop site that are listed in maintenance mode in the DDC. It must be run on a XenDesktop broker. The script prompts for and requires at least a XenDesktop read-only admin account.
Version: 1.3.8
Created: 2016-05-04
Modified: 2016-05-05
Creator: Matan Nataf
Downloads: 286
Tags: maintenance mode powershell xendesktop
The Script Copy Script Copied to clipboard
<#  
.SYNOPSIS
      This script outputs a list of all the VMs from a XenDesktop site, that are in maintenance mode.
.DESCRIPTION
      This script will list all the VMs in a specific XenDesktop site that are in maintenance mode.
      It must be run on a XenDesktop broker.
.PARAMETER 
       No parameters.
.EXAMPLE
        GetMaintenanceModeMachines.ps1
.OUTPUTS
        A text list with the VMs in a given XenDesktop site that are in maintenance mode.
.LINK
        See http://www.ControlUp.com
#>

$ErrorActionPreference = "Stop"

$VMs = @()

If ( (Get-PSSnapin -Name Citrix.Broker.Admin.* -ErrorAction SilentlyContinue) -eq $null )
{
    Try {
        Add-PSSnapin Citrix.Broker.Admin.* | Out-Null
    } Catch {
        Write-Host "Unable to load Citrix Snapin. It is not possible to continue."
        Exit 1
    }
}

$VMs = Get-BrokerDesktop -InMaintenanceMode $true

If ($VMs) {
    Write-Host "Machines In Maintenance Mode:"
    ForEach ($vm in $VMs) {
        $vm.MachineName
      }
      Write-Host "Total:"$vms.Count
} Else {
    Write-Host "There are no machines in maintenace mode!"
}