Skip to main content

Pia: Remote Desktop Troubleshooting

Overview​

This package allows the Chat User to troubleshoot RDP shortcuts for the end user. It will check:

  • User account locked or disabled
  • Expired Password
  • Member of the correct security group

Platforms​

The package supports the following platforms

  • All

Requirements​

Orchestrator agents in a valid state on

  • Primary Domain Controller
  • Target Workstation

Cloud Only & Cloud Hybrid

  • Microsoft Graph API Authorization and Delegation

Setup & Configuration​

Opt-In

  • This package requires to be manually opted into

Tags (either)

  • RDE: Windows RDP
  • RDE: Windows RDWeb

Global Config

  • Primary Domain Controller

Package Config

  • Remote Desktop Type
  • Profile Name
  • URL/Server Address
  • Security Group
  • Properties

Cloud Only & Cloud Hybrid

  • Microsoft Graph API Authorization and Delegation

Process​

The steps that the package takes during process execution are:

  1. Pia will obtain a list of users and sends a form prompting the engineer to select a user to troubleshoot issues for.
  2. Pia will then obtain a list of machines for the user and send a form prompting the engineer to select a users workstation
    • If none exist, Pia will return a list of all available workstations for the client.
  3. Pia will check the user account for these issues:
    • If the account is locked out, Pia will prompt the engineer to unlock the account
    • If the password has expired, Pia will prompt the engineer to reset the password.
    • If the account is disabled, Pia will prompt the engineer to enable the account
    • If not a member of the RDP Group, Pia will prompt the engineer to add the user to the group
  4. Pia will then troubleshoot the remote desktop profile and perform the following actions:
    • If the profile does not exist, Pia will prompt the engineer to enable the account
    • If the profile is incorrectly configured, Pia will prompt the engineer to set the correct values
  5. Pia will then run the troubleshooting steps in Step 3 before finally outputting the final diagnostic results for review.