https://github.com/dsccommunity/ComputerManagementDsc

DSC resources for for configuration of a Windows computer. These DSC resources allow you to perform computer management tasks, such as renaming the computer, joining a domain and scheduling tasks as well as configuring items such as virtual memory, event logs, time zones and power settings.
https://github.com/dsccommunity/ComputerManagementDsc

dsc dsc-resources powershell-dsc

Last synced: 5 months ago
JSON representation

DSC resources for for configuration of a Windows computer. These DSC resources allow you to perform computer management tasks, such as renaming the computer, joining a domain and scheduling tasks as well as configuring items such as virtual memory, event logs, time zones and power settings.

• Host: GitHub
• URL: https://github.com/dsccommunity/ComputerManagementDsc
• Owner: dsccommunity
• License: mit
• Created: 2015-04-15T22:42:57.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2024-02-12T21:20:03.000Z (about 1 year ago)
• Last Synced: 2024-03-15T02:14:25.121Z (about 1 year ago)
• Topics: dsc, dsc-resources, powershell-dsc
• Language: PowerShell
• Homepage: https://dsccommunity.org
• Size: 2.43 MB
• Stars: 284
• Watchers: 34
• Forks: 80
• Open Issues: 74
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

• jimsghstars - dsccommunity/ComputerManagementDsc - DSC resources for for configuration of a Windows computer. These DSC resources allow you to perform computer management tasks, such as renaming the computer, joining a domain and scheduling tasks as w (PowerShell)

README

        
# ComputerManagementDsc

[![Build Status](https://dev.azure.com/dsccommunity/ComputerManagementDsc/_apis/build/status/dsccommunity.ComputerManagementDsc?branchName=main)](https://dev.azure.com/dsccommunity/ComputerManagementDsc/_build/latest?definitionId=18&branchName=main)

![Code Coverage](https://img.shields.io/azure-devops/coverage/dsccommunity/ComputerManagementDsc/18/main)

[![Azure DevOps tests](https://img.shields.io/azure-devops/tests/dsccommunity/ComputerManagementDsc/18/main)](https://dsccommunity.visualstudio.com/ComputerManagementDsc/_test/analytics?definitionId=18&contextType=build)

[![PowerShell Gallery (with prereleases)](https://img.shields.io/powershellgallery/vpre/ComputerManagementDsc?label=ComputerManagementDsc%20Preview)](https://www.powershellgallery.com/packages/ComputerManagementDsc/)

[![PowerShell Gallery](https://img.shields.io/powershellgallery/v/ComputerManagementDsc?label=ComputerManagementDsc)](https://www.powershellgallery.com/packages/ComputerManagementDsc/)

[![codecov](https://codecov.io/gh/dsccommunity/ComputerManagementDsc/branch/main/graph/badge.svg)](https://codecov.io/gh/dsccommunity/ComputerManagementDsc)

## Code of Conduct

This project has adopted [this code of conduct](CODE_OF_CONDUCT.md).

## Releases

For each merge to the branch `main` a preview release will be

deployed to [PowerShell Gallery](https://www.powershellgallery.com/).

Periodically a release version tag will be pushed which will deploy a

full release to [PowerShell Gallery](https://www.powershellgallery.com/).

## Contributing

Please check out common DSC Community [contributing guidelines](https://dsccommunity.org/guidelines/contributing).

## Change log

A full list of changes in each version can be found in the [change log](CHANGELOG.md).

## Resources

The **ComputerManagementDsc** module contains the following resources:

- **Computer**: This resource allows you to configure a computer by changing its

  name and description and modifying its Active Directory domain or workgroup

  membership.

- **IEEnhancedSecurityConfiguration**: This resource allows you to configure

  the IE Enhanced Security Configuration for administrator or user roles.

- **OfflineDomainJoin**: This resource allows you to join computers to an Active

  Directory domain using an [Offline Domain Join](https://technet.microsoft.com/en-us/library/offline-domain-join-djoin-step-by-step(v=ws.10).aspx)

  request file.

- **PendingReboot**: This resource examines specific registry locations where

  a Windows Server might indicate that a reboot is pending and allows DSC to

  predictably handle the condition.

- **PowerPlan**: This resource allows specifying a power plan to activate.

- **PowerShellExecutionPolicy**: Specifies the desired PowerShell execution policy.

- **PSResourceRepository**: This resource manages PowerShellGet repositories.

- **RemoteDesktopAdmin**: This resource will manage the remote desktop administration

  settings on a computer.

- **ScheduledTask**: This resource is used to define basic run once or recurring

  scheduled tasks on the local computer. It can also be used to delete or disable

  built-in scheduled tasks.

  _The **ScheduledTask** resource requires the `ScheduledTasks` PowerShell module

  which is only available on Windows Server 2012/Windows 8 and above. DSC configurations

  containing this resource may be compiled on Windows Server 2008 R2/Windows 7 but

  can not be applied._

- **SmbServerConfiguration**: This resource is used to configure the SMB Server

  settings on the local machine.

- **SmbShare**: This resource is used to manage SMB shares on a machine.

- **SystemLocale**: This resource is used to set the system locale on a

  Windows machine

- **SystemProtection**: This resource is used to configure System Protection settings

  on a workstation (servers are not supported).

- **SystemRestorePoint**: This resource is used to create and delete restore points

  when System Protection is enabled (servers are not supported).

- **TimeZone**: This resource is used for setting the time zone on a machine.

- **UserAccountControl**: This resource allows you to configure the notification

  level or granularly configure the User Account Control for the computer.

- **VirtualMemory**: This resource allows configuration of properties of the

  paging file on the local computer.

- **WindowsEventLog**: This resource allows configuration of a specified

  Windows Event Log.

- **WindowsCapability**: This resource provides a mechanism to enable or disable

  Windows Capabilities on a target node.

This project has adopted [this code of conduct](CODE_OF_CONDUCT.md).

## Documentation and Examples

For a full list of resources in ComputerManagementDsc and examples on their use,

check out the [ComputerManagementDsc wiki](https://github.com/dsccommunity/ComputerManagementDsc/wiki).

## Requirements

### Windows Management Framework 5.0

Required because this module now implements class-based resources.

Class-based resources can only work on computers with Windows

Management Framework 5.0 or above.

### PSResourceRepository

The resource `PSResourceRepository` requires that the PowerShell modules `PowerShellGet` and `PackageManagement` are already present on the target computer.