While working on an update to the Citrix Cloud documentation script, with the help of sample reports from fellow CTP Arnaud Pain, I was able to find and fix numerous issues in the script. I backported the fixes relevant to on-premises CVAD to this script.

Version 3.26 13-Apr-2021

• Changed $Application.IconFromClient to $Application.IconFromClient.ToString()
• Changed how the Session Recording Status was obtained
• Fixed three typos of “Unabled” to “Unable”
• For the following three Delivery Group properties, if there is no data or value, use “-” to match all the other empty values
  • All connections not through NetScaler Gateway
  • Connections through NetScaler Gateway
  • Restrict to tag
• In Machine details added
  • Draining Until Shutdown (Multi-session only)
  • Last Connection Failure reason
    • “None” = “None”
    • “SessionPreparation” = “Session preparation”
    • “RegistrationTimeout” = “Registration timeout”
    • “ConnectionTimeout” = “Connection Timeout”
    • “Licensing” = “Licensing”
    • “Ticketing” = “Ticketing”
    • “Other” = “Other”
  • Maintenance Mode reason
    • “Administrator” = “Machine was manually placed in maintenance mode by an administrator”
    • “MaxFailedRegistrations” = “Machine was automatically placed in maintenance mode due to reaching the maximum failed registration limit”
    • “None” = “Machine is not in maintenance mode”
  • Will Shutdown After Use reason
    • “None” = “Machine will not shutdown after use”
    • “ResetDiskImage” = “Machine will shutdown after use to reset its disk image”
    • “ScheduledNaturalReboot” = “Machine will shutdown after use as part of the scheduled natural reboot process”
    • “OnDemandNaturalReboot” = “Machine will shutdown after use as part of an on-demand natural reboot process”
• In Machine Details, for MCS catalogs, if the Provisioning Scheme doesn’t exist, set the $MasterVM variable to “Unable to retrieve details”
• To get the Master VM for an Azure Catalog, add searching for “.manageddisk”
  • Also added “.snapshot” which was found in customer data
• Updated the text explanations for:
  • Machine Fault State
    • “None” = “No fault; machine is healthy”
    • “FailedToStart” = “Last power-on operation for machine failed”
    • “StuckOnBoot” = “Machine does not seem to have booted following power on”
    • “Unregistered” = “Machine has failed to register within expected period, or its registration has been rejected”
    • “MaxCapacity” = “Machine is reporting itself at maximum capacity”
  • Machine Scheduled Reboot
    • “None” = “No reboot is scheduled”
    • “Pending” = “Machine is awaiting reboot but is available for us”
    • “Draining” = “Machine is awaiting reboot and is unavailable for new sessions; reconnections to existing connections are still allowed, however”
    • “InProgress” = “Machine is actively undergoing a scheduled reboot”
    • “Natural” = “Natural reboot in progress. Machine is awaiting a restart”
• When testing a session for Session Recording status, add a test for $null -ne $results

You can always find the most current script by going to https://www.carlwebster.com/where-to-get-copies-of-the-documentation-scripts/

Thanks

Webster