{"id":23312423,"url":"https://github.com/mcollera/resourcecontrollerdsc","last_synced_at":"2025-08-22T13:31:09.587Z","repository":{"id":29578366,"uuid":"122120161","full_name":"mcollera/ResourceControllerDSC","owner":"mcollera","description":null,"archived":false,"fork":false,"pushed_at":"2022-01-24T04:40:11.000Z","size":52,"stargazers_count":5,"open_issues_count":2,"forks_count":1,"subscribers_count":4,"default_branch":"dev","last_synced_at":"2024-05-15T09:48:30.746Z","etag":null,"topics":["dsc-resources","maintenance-windows","reboot","resourcecontroller","schedules-execution","suppress-reboot"],"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/mcollera.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}},"created_at":"2018-02-19T21:02:04.000Z","updated_at":"2022-11-12T23:05:28.000Z","dependencies_parsed_at":"2022-08-07T14:30:23.965Z","dependency_job_id":null,"html_url":"https://github.com/mcollera/ResourceControllerDSC","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcollera%2FResourceControllerDSC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcollera%2FResourceControllerDSC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcollera%2FResourceControllerDSC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcollera%2FResourceControllerDSC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcollera","download_url":"https://codeload.github.com/mcollera/ResourceControllerDSC/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230598564,"owners_count":18251203,"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":["dsc-resources","maintenance-windows","reboot","resourcecontroller","schedules-execution","suppress-reboot"],"created_at":"2024-12-20T14:30:05.305Z","updated_at":"2024-12-20T14:30:06.023Z","avatar_url":"https://github.com/mcollera.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ResourceControllerDSC\n\nmaster: [![Build status](https://ci.appveyor.com/api/projects/status/qghpa6k5dfmc05i0/branch/master?svg=true)](https://ci.appveyor.com/project/mcollera/resourcecontrollerdsc/branch/master)\n\ndev: [![Build status](https://ci.appveyor.com/api/projects/status/qghpa6k5dfmc05i0/branch/dev?svg=true)](https://ci.appveyor.com/project/mcollera/resourcecontrollerdsc/branch/dev)\n\nThe **ResourceControllerDSC** module allows you to control other DSC resources by adding a Maintenance Window so Set-TargetResource will only run during that window.\nAlso allows you to supress a reboot when a resource does not have the option.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](\n  https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](\n  https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions\nor comments.\n\n## Contributing\n\nPlease check out common DSC Resources [contributing guidelines](\n  https://github.com/PowerShell/DscResources/blob/master/CONTRIBUTING.md).\n\n## Resources\n\n* [**ResourceController**](#ResourceController): Provides the ability to add a maintenance window and supress reboots. Maintenance windows and Supress reboots only effect Set-TargetResource. Get and Test will always run for reporting.\n\n### **ResourceController**\n\n* **[String] InstanceName** _(Key)_: A unique name to give the resource.\n\n* **[String] ResourceName**: The name of the resource you want to run.\n\n* **[Scriptblock] Properties:** A Scriptblock that returns a Hashtable of the properties for the resource you are calling.\n  \n* **[Credential] Credentials:** Credentials you want to use as properties in the Properties Scriptblock.\n    * **[String] Name:** The name of the credential. Used to reference the credential in the properties.\n    * **[PSCredential] Credential:** The Credential object.\n\n* **[MaintenanceWindow] MaintenanceWindow:** Object representing a maintenance window\n    DaysofWeek\n    Week\n    Days\n    * **[string] Frequency:** The frequency the schedule should run. _{ Daily | Weekly | Monthly }_\n    * **[DateTime] StartTime:** The start time the resource is aloud to run Set-TargetResource when the day is inside the maintenance window\n    * **[DateTime ] EndTime:** The end time the resource is aloud to run Set-TargetResource when the day is inside the maintenance window\n    * **[DateTime] StartDate:** The date the resource is aloud to run Set-TargetResource.\n    * **[DateTime] EndDate:** The date the resource will no longer run Set-TargetResource.\n    * **[String[]] DaysofWeek:** The days of week Set-TargetResource will run. _{ Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday }_\n    * **[int[] Week:** The week in the month you want Set-TargetResource to run. {0} represents the last week of the month. _{ 0 | 1 | 2 | 3 | 4 }_\n    * **[int[]] Days:** The day in the month you want Set-TargetResource to run. {0} represents the last day of the month. _{ 0-31 }_\n\n* **[bool] SupressReboot:** Whether you should supress a forced reboot. _{ True | False }_\n\n#### ResourceController Examples\n\n* [ResourceController Examples](\n  https://github.com/mcollera/ResourceControllerDsc/blob/master/Examples/ResourceController_Examples.ps1)\n\n## Versions\n\n### 2.0.1\n  * Removed parameter validation to avoid potential issues with ValidateScript\n\n### 2.0.0\n  * Added Credential object to use in the properties.\n  * Converted Properties from a Hashtable to a Scriptblock so it can handle more object types like arrays. If     you want to use a PsCredential then you set the value to [PsCredential]:\u003c Name\u003e. This will replace that        string with the credential object matching the name of the credential passed in the Credential parameter.\n\n### 1.3.1\n  Converted resource parameters to there desired type.\n\n### 1.3\n  Breaking Change: Fixed variable names in DSCResource\n\n### 1.2\n  Breaking Change: Add ResourceVersion to support systems with multiple versions installed.\n\n### 1.1\n\n* Fixed bug: Test-MaintenanceWindow would fail if one Maintenance Window of an array of windows was outside the window.\n\n### 1.0.0.0\n\n* Initial release with the following resources:\n\n  * ResourceController\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcollera%2Fresourcecontrollerdsc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcollera%2Fresourcecontrollerdsc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcollera%2Fresourcecontrollerdsc/lists"}