Enable-RDPRemotelyWMI.ps1

• Description
  • Script
  • Download
  • Report Issues

Description

@GitHub Copilot - Welcome @BanterBoy, I’m your Copilot and I’m here to help you get things done faster. I can identify issues, explain and even improve code.

You can ask generic questions, but what I’m really good at is helping you with your code. For example:

Generate unit tests for my code Explain the selected code Propose a fix for the bugs in my code If you want to learn more about my capabilities and limitations, check out the Copilot documentation.

I’m powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve.

@BanterBoy: - Explain what the script does and why it is useful.

@GitHub Copilot - The code above is a PowerShell function called Enable-RDPRemotelyWMI. This function enables Remote Desktop Protocol (RDP) on a remote host by running two lines of code.

The function is defined with [CmdletBinding()] and a param block that takes a parameter called $ComputerName. This parameter is an array of strings that represents the names of the remote computers on which RDP needs to be enabled.

The function then uses a foreach loop to iterate through each computer name in the $ComputerName array. Inside the loop, the function uses the Get-WmiObject cmdlet to retrieve an instance of the Win32_TerminalServiceSetting class from the root/cimv2/TerminalServices namespace on the remote computer. This instance is stored in the $tsobj variable.

Finally, the function uses the SetAllowTSConnections method on the $tsobj object to enable RDP and modify the firewall exception to allow RDP traffic. This method takes two arguments: AllowTSConnections and ModifyFirewallException. Both arguments are set to 1, which enables RDP and modifies the firewall exception to allow RDP traffic.

In terms of improving the code, one possible suggestion is to add error handling to the function. For example, if a remote computer is not reachable or does not have the necessary permissions to enable RDP, the function should gracefully handle these errors and provide feedback to the user. Additionally, the function could be made more efficient by using PowerShell remoting to enable RDP on multiple remote computers simultaneously.

@BanterBoy: - Explain how to use the script and provide examples.

@GitHub Copilot - Sure! Here are a few examples of how to use the Enable-RDPRemotelyWMI function:

# Enable RDP on a single remote computer
Enable-RDPRemotelyWMI -ComputerName "computer1"

# Enable RDP on multiple remote computers
Enable-RDPRemotelyWMI -ComputerName "computer1", "computer2", "computer3"

# Enable RDP on remote computers listed in a text file
$computers = Get-Content "C:\computers.txt"
Enable-RDPRemotelyWMI -ComputerName $computers

In the first example, the Enable-RDPRemotelyWMI function is called with the -ComputerName parameter, which takes a string representing the name of the remote computer on which RDP needs to be enabled. In this case, RDP will be enabled on a single remote computer named “computer1”.

In the second example, the Enable-RDPRemotelyWMI function is called with the -ComputerName parameter, which takes an array of strings representing the names of the remote computers on which RDP needs to be enabled. In this case, RDP will be enabled on three remote computers named “computer1”, “computer2”, and “computer3”.

In the third example, the Get-Content cmdlet is used to read the contents of a text file containing a list of remote computer names. The $computers variable is then passed to the -ComputerName parameter of the Enable-RDPRemotelyWMI function, which enables RDP on all of the remote computers listed in the text file.

Script

function Enable-RDPRemotelyWMI {
    # You can enable RDP on a remote host by simply running the below two lines.
    [CmdletBinding()]
    param (
        [Parameter()]
        [string[]]
        $ComputerName
    )
    foreach ($Computer in $ComputerName) {
        $tsobj = Get-WmiObject -Class Win32_TerminalServiceSetting -Namespace Root\CimV2\TerminalServices -ComputerName $Computer
        $tsobj.SetAllowTSConnections(1, 1)
    }
}

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.

Download

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

Back to myProfile