{"id":15192168,"url":"https://github.com/powershell/dscconfigurations","last_synced_at":"2025-10-02T06:32:35.367Z","repository":{"id":65985518,"uuid":"78472348","full_name":"PowerShell/DscConfigurations","owner":"PowerShell","description":null,"archived":true,"fork":false,"pushed_at":"2017-04-19T21:36:19.000Z","size":10,"stargazers_count":28,"open_issues_count":1,"forks_count":8,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-07-29T17:35:41.149Z","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/PowerShell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-09T21:51:20.000Z","updated_at":"2024-09-17T18:02:43.000Z","dependencies_parsed_at":"2023-02-19T18:30:44.480Z","dependency_job_id":null,"html_url":"https://github.com/PowerShell/DscConfigurations","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PowerShell/DscConfigurations","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerShell%2FDscConfigurations","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerShell%2FDscConfigurations/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerShell%2FDscConfigurations/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerShell%2FDscConfigurations/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PowerShell","download_url":"https://codeload.github.com/PowerShell/DscConfigurations/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerShell%2FDscConfigurations/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277968828,"owners_count":25907418,"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","status":"online","status_checked_at":"2025-10-02T02:00:08.890Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-09-27T21:05:50.999Z","updated_at":"2025-10-02T06:32:35.134Z","avatar_url":"https://github.com/PowerShell.png","language":"PowerShell","readme":"# DSC Configurations\n\n[![Join the chat at https://gitter.im/PowerShell/DscResources](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/PowerShell/DscResources?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nWindows PowerShell Desired State Configuration (DSC) provides a configuration platform that is based on open standards.\nThis repo provides a structured listing of **DSC Configurations** and guidance for Open Source community contribution.\nFor information about the scripts that perform work described by Configurations, see the GitHub repo for [DSC Resources](http://github.com/powershell/dscresources). \n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\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.\n\n# Sharing Configurations\n## Publishing a config to the Gallery should be done in one of these ways:\n\n### Configuration Script\nIf the Config is a script, create and require in the Script a separate module that contains the docs, help, examples, \u0026 tests. \nThis ensures when the script is published or downloaded using PSGet cmdlets, the module will be brought along.\n\nYou **must** use the RequiredModule metadata to specify the linked module.\n\nIf there is a separate Config Data (PSD1) file, it belongs in the module. You **must** document how it is used.\n\nYou **should** include a line generating the MOF in the script.\n\nYou **may** include the Start-DscConfiguration command in the script. This means the script will be complete, but the deployment will start on script execution when it may or may not be appropriate in the user’s environment. \n\n### Composite Resource\nIf the Config is a Composite Resource, publish as a module that contains all the other items. \nYou **should** consider publishing a script that uses the composite resource as in the preceeding option.\n\n## Sharing relies on completing important metadata \n```New-ModuleManifest``` and ```New-ScriptFileInfo``` will generate the placeholders for the metadata needed.\n\nAll items published to the Gallery **must** have the correct metadata filled in for:\n- Author\n- Description\n- Version\n- Company name\n- Copyright. \n\nYou **should** consider associating DSC resources with your configuration by using RequiredModule statements. \nThis is a general best practice, as it allows users to make a single call to the gallery to geet all preqrequisites for running the script. However, there may be situations where it is incorrect.\n\nIf you are using the DSCConfiguration.Tests repo to automate hosting tests on Azure VM's, you **should** also populate the a new property in PSPrivateData named \"WindowsOSVersion\" and set the value to one of the strings supported by AzureRM.\n\n# Authoring guidelines\n\nThe [DSC Resource repository](http://github.com/powershell/dscresources) includes guidance on authoring that is applicable to configurations as well.\nFor more information, visit the links below:\n\n - [Best practices](https://github.com/PowerShell/DscResources/blob/master/BestPractices.md)\n - [Style guidelines](https://github.com/PowerShell/DscResources/blob/master/StyleGuidelines.md)\n - [Maintainers](https://github.com/PowerShell/DscResources/blob/master/Maintainers.md)\n\n\n# Community Discussion\n\nThere is a monthly community call hosted on Skype where new submissions and technical topics are discussed.\nFor more information visit the topic [Community Agenda](https://github.com/PowerShell/DscResources/blob/master/CommunityAgenda.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowershell%2Fdscconfigurations","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpowershell%2Fdscconfigurations","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowershell%2Fdscconfigurations/lists"}