Get-RDPStatusCIM.ps1

19 Sep 2025

• Description
  • Script
  • Download
  • Report Issues

---

Description

Get-RDPStatusCIM queries the Win32_TerminalServiceSetting CIM class to report whether Remote Desktop is enabled or disabled on each target computer. The function writes "RDP Enabled" or "RDP Disabled" for every host in the -ComputerName list.

Usage examples

Get-RDPStatusCIM -ComputerName 'srv01','srv02'
$computers | Get-RDPStatusCIM

Use the output to determine whether to call the enable or disable helpers before making firewall or RDP changes.

---

Script

function Get-RDPStatusCIM {
    # Do you care to check if it is currently enabled or disabled before acting? Use the below code.
    [CmdletBinding()]
    param (
        [Parameter()]
        [string[]]
        $ComputerName
    )
    foreach ($Computer in $ComputerName) {
        $tsobj = Get-CimInstance -ClassName "Win32_TerminalServiceSetting" -Namespace "root/CIMV2/TerminalServices" -ComputerName $Computer
        if ($tsobj.AllowTSConnections -eq '1') {
            Write-Output "RDP Enabled"
        }
        if ($tsobj.AllowTSConnections -eq '0') {
            Write-Output "RDP Disabled"
        }
    }
}

Back to Top

---

Download

Please feel free to copy parts of the script or if you would like to download the entire script, simple click the download button. You can download the complete repository in a zip file by clicking the Download link in the menu bar on the left hand side of the page.

---

Report Issues

You can report an issue or contribute to this site on GitHub. Simply click the button below and add any relevant notes. I will attempt to respond to all issues as soon as possible.

Issue

---

Back to Top