Skip to content
dev
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

THIS MODULE HAS BEEN DEPRECATED

It will no longer be released. Please use the 'RemoteDesktopAdmin' resource in ComputerManagementDsc instead.

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

  • THIS MODULE HAS BEEN DEPRECATED. It will no longer be released. Please use the 'RemoteDesktopAdmin' resource in ComputerManagementDsc instead.
  • 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.

About

No description, website, or topics provided.

Resources

License

Packages

No packages published