{"id":20156263,"url":"https://github.com/dsccommunity/xremotedesktopadmin","last_synced_at":"2025-04-09T22:23:28.466Z","repository":{"id":72632335,"uuid":"34022247","full_name":"dsccommunity/xRemoteDesktopAdmin","owner":"dsccommunity","description":null,"archived":false,"fork":false,"pushed_at":"2019-09-19T08:13:23.000Z","size":53,"stargazers_count":17,"open_issues_count":2,"forks_count":18,"subscribers_count":24,"default_branch":"dev","last_synced_at":"2025-03-24T00:16:45.131Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dsccommunity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-04-15T22:43:04.000Z","updated_at":"2024-09-01T23:08:01.000Z","dependencies_parsed_at":"2023-04-15T22:05:40.163Z","dependency_job_id":null,"html_url":"https://github.com/dsccommunity/xRemoteDesktopAdmin","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxRemoteDesktopAdmin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxRemoteDesktopAdmin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxRemoteDesktopAdmin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dsccommunity%2FxRemoteDesktopAdmin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dsccommunity","download_url":"https://codeload.github.com/dsccommunity/xRemoteDesktopAdmin/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248120911,"owners_count":21051045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T23:38:13.676Z","updated_at":"2025-04-09T22:23:28.454Z","avatar_url":"https://github.com/dsccommunity.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **THIS MODULE HAS BEEN DEPRECATED**\r\n\r\nIt will no longer be released.\r\nPlease use the 'RemoteDesktopAdmin' resource in [ComputerManagementDsc](https://github.com/PowerShell/ComputerManagementDsc)\r\ninstead.\r\n\r\n[![Build status](https://ci.appveyor.com/api/projects/status/iwctay9q3t2c72r8/branch/master?svg=true)](https://ci.appveyor.com/project/PowerShell/xremotedesktopadmin/branch/master)\r\n\r\n# xRemoteDesktopAdmin\r\n\r\nThe **xRemoteDesktopAdmin** module contains the **xRemoteDesktopAdmin** DSC resource for configuring remote desktop settings and the Windows firewall on a local or remote machine.\r\n\r\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\r\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\r\n\r\n## Contributing\r\nPlease check out common DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md).\r\n\r\n\r\n## Description\r\n\r\nThe **xRemoteDesktopAdmin** module contains the **xRemoteDesktopAdmin** DSC Resource.\r\nThis 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.\r\nIn addition, it can optionally leverage the xPSDesiredStateConfiguration resources **xFirewall** and **xGroup**.\r\nThis 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.\r\n\r\n\r\n## Resources\r\n\r\n### xRemoteDesktopAdmin\r\n\r\n* **Ensure**: Ensures that �remote connections to this computer� are allowed or disallowed: { Absent | Present }\r\n* **UserAuthentication**: Enables or disables �Network Level Authentication�. Valid values are:\r\n  * Secure\r\n  * NonSecure\r\n\r\n\r\n## Versions\r\n\r\n### Unreleased\r\n\r\n* THIS MODULE HAS BEEN DEPRECATED. It will no longer be released.\r\n  Please use the 'RemoteDesktopAdmin' resource in ComputerManagementDsc instead.\r\n* Update appveyor.yml to use the default template.\r\n* Added default template files .codecov.yml, .gitattributes, and .gitignore, and\r\n  .vscode folder.\r\n\r\n### 1.1.0.0\r\n\r\n* Updated OutputType to System.Boolean for Test-TargetResource and removed for Set-TargetResource.\r\nxRemoteDesktopSessionHost\r\n\r\n### 1.0.3.0\r\n\r\n* Updated examples\r\n\r\n### 1.0.2.0\r\n\r\n* Update to correct issue in Set-TargetResource when checking Ensure\r\n\r\n### 1.0.0.0\r\n\r\n* Initial release with the following resource:\r\n    * xRemoteDesktopAdmin\r\n\r\n\r\n## Examples\r\n\r\n### [ExampleConfiguration-RemoteDesktopAdmin.ps1](Examples/ExampleConfiguration-RemoteDesktopAdmin.ps1)\r\n\r\nThis 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.\r\n\r\n### [ExampleConfiguration-RemoteDesktopAdminWithUnEncryptedPassword.ps1](Examples/ExampleConfiguration-RemoteDesktopAdminWithUnEncryptedPassword.ps1)\r\n\r\nThis 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).\r\nNote: this Example requires the built-in **Group** resource.\r\n\r\n### [ExampleConfiguration-RemoteDesktopAdminWithEncryptedPassword.ps1](Examples/ExampleConfiguration-RemoteDesktopAdminWithEncryptedPassword.ps1)\r\n\r\nThis 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.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxremotedesktopadmin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdsccommunity%2Fxremotedesktopadmin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdsccommunity%2Fxremotedesktopadmin/lists"}