Skip to content
No description, website, or topics provided.
PowerShell
Branch: dev
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add pull request template and issue templates (#20) Aug 23, 2018
.vscode Update to use template files (#21) Sep 22, 2018
DSCResources/xRemoteDesktopAdmin Fixes #10. OutputType updated to System.Boolean for Test-TargetResour… Aug 30, 2015
Examples Suppressed PSAvoidUsingConvertToSecureStringWithPlainText rule. It is… Aug 8, 2016
.codecov.yml Update to use template files (#21) Sep 22, 2018
.gitattributes
.gitignore Update to use template files (#21) Sep 22, 2018
LICENSE Transfer development to github Apr 15, 2015
README.md Update to use template files (#21) Sep 22, 2018
appveyor.yml Update to use template files (#21) Sep 22, 2018
xRemoteDesktopAdmin.psd1

README.md

Build status

xRemoteDesktopAdmin

The xRemoteDesktopAdmin module contains the xRemoteDesktopAdmin DSC resource for configuring remote desktop settings and the Windows firewall on a local or remote machine.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Contributing

Please check out common DSC Resources contributing guidelines.

Description

The xRemoteDesktopAdmin module contains the xRemoteDesktopAdmin DSC Resource. This DSC Resource allows you to configure remote desktop settings to either allow or prevent users to setup a remote desktop connection to a specific machine. In addition, it can optionally leverage the xPSDesiredStateConfiguration resources xFirewall and xGroup. This allows you to configure remote desktop settings and create the necessary firewall rules to allow a remote session and add a domain user to the local Remote Desktop Users group.

Resources

xRemoteDesktopAdmin

  • Ensure: Ensures that �remote connections to this computer� are allowed or disallowed: { Absent | Present }
  • UserAuthentication: Enables or disables �Network Level Authentication�. Valid values are:
    • Secure
    • NonSecure

Versions

Unreleased

  • Update appveyor.yml to use the default template.
  • Added default template files .codecov.yml, .gitattributes, and .gitignore, and .vscode folder.

1.1.0.0

  • Updated OutputType to System.Boolean for Test-TargetResource and removed for Set-TargetResource. xRemoteDesktopSessionHost

1.0.3.0

  • Updated examples

1.0.2.0

  • Update to correct issue in Set-TargetResource when checking Ensure

1.0.0.0

  • Initial release with the following resource:
    • xRemoteDesktopAdmin

Examples

ExampleConfiguration-RemoteDesktopAdmin.ps1

This configuration configures the target system to allow for remote connections (i.e. allows an RDP session to be setup), enables Network Level Authentication and creates a Windows firewall rule to allow incoming RDP traffic.

ExampleConfiguration-RemoteDesktopAdminWithUnEncryptedPassword.ps1

This configuration extends the previous configuration by adding a domain user to the local Remote Desktop Users group using a credential stored in clear text (for testing purposes only). Note: this Example requires the built-in Group resource.

ExampleConfiguration-RemoteDesktopAdminWithEncryptedPassword.ps1

This configuration extends the previous configuration by adding a domain user to the local Remote Desktop Users group using certificates to encrypt credentials. Please refer to [this blog post](please refer to http://blogs.msdn.com/b/powershell/archive/2014/01/31/want-to-secure-credentials-in-windows-powershell-desired-state-configuration.aspx) for more info on how to use certificates to encrypt passwords.

You can’t perform that action at this time.