ComputerManagementDsc

10.0.0-preview0006

DSC resources 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.

Minimum PowerShell version

5.0

This is a prerelease version of ComputerManagementDsc.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name ComputerManagementDsc -RequiredVersion 10.0.0-preview0006 -AllowPrerelease

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name ComputerManagementDsc -Version 10.0.0-preview0006 -Prerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

Copyright the DSC Community contributors. All rights reserved.

Package Details

Author(s)

  • DSC Community

Tags

DesiredStateConfiguration DSC DSCResource

DSCResources

Computer OfflineDomainJoin PendingReboot PowerPlan PowerShellExecutionPolicy RemoteDesktopAdmin ScheduledTask SmbServerConfiguration SmbShare SystemLocale SystemProtection SystemRestorePoint TimeZone VirtualMemory WindowsEventLog WindowsCapability IEEnhancedSecurityConfiguration UserAccountControl PSResourceRepository

Dependencies

This module has no dependencies.

Release Notes

## [10.0.0-preview0006] - 2025-01-25

### Added

- SystemProtection
 - New resource to configure System Protection settings (formerly xWindowsRestore) - Fixes [Issue #364](https://github.com/dsccommunity/ComputerManagementDsc/issues/364).
- SystemRestorePoint
 - New resource to create and delete restore points (formerly xSystemRestorePoint) - Fixes [Issue #364](https://github.com/dsccommunity/ComputerManagementDsc/issues/364).
- ScheduledTask
 - Added support for ScheduleType 'OnIdle', 'AtCreation', 'OnSessionState'.
   Fixes [Issue #282](https://github.com/dsccommunity/ComputerManagementDsc/issues/282).
 - Added support for StateChange to allow specifying which session state changes should
   trigger the task (with ScheduleType = OnSessionState).
 - Added support for StopAtDurationEnd permitting control over the 'Stop all running tasks
   at the end of the repetition duration' feature.
   Fixes [Issue #168](https://github.com/dsccommunity/ComputerManagementDsc/issues/168).
 - Added support for TriggerExecutionTimeLimit permitting control over per-trigger 'Stop task
   if it runs longer than...' feature.

### Fixed

- BREAKING CHANGE: ScheduledTask
 - Fixed SynchronizeAcrossTimeZone issue where Test always throws False when a date & time is used
   where Daylight Savings Time is in operation. Fixes [Issue #374](https://github.com/dsccommunity/ComputerManagementDsc/issues/374).
 - Fixed Test-DateStringContainsTimeZone to correctly process date strings behind UTC (-), as well
   as UTC Zulu 'Z' strings.
 - Fixed User parameter to correctly return the user that triggers an AtLogon or OnSessionState
   Schedule Type, instead of the current value of ExecuteAsCredential. This parameter
   is only valid when using the AtLogon and OnSessionState Schedule Types.
 - Fixed User parameter to permit use even if LogonType = Group.
 - Updated RandomDelay logic from a blacklist to a whitelist.
 - Updated Delay parameter logic to reflect other TimeSpan based values.
 - Updated unit tests to use Should -Invoke for Pester 5 compatibility.
 - Updated various parameters with requirements in documentation.
- `VirtualMemory` fix incorrect variable name
- `SmbServerConfiguration` remove errant argument
- Update all calls to edit the registry so that the value Type is explicitly set.
 Fixes [Issue #433](https://github.com/dsccommunity/ComputerManagementDsc/issues/433).
- Made AppVeyor use ModuleFast to resolve dependencies.

### Changed

- BREAKING CHANGE: ScheduledTask
 - StartTime has chnage the type from DateTime to String.
 - StartTime is now processed on the device, rather than at compile time. This makes it possible
   to configure start times based on each device's timezone, rather than being fixed to the time zone
   configured on the device where the Desired State Configuration compilation was run.
 - Allow StartTime to be used to set the 'Activate' setting when adding ScheduleType triggers
   other than 'Once', 'Daily' and 'Weekly'.
 - Changed the default StartTime date from today to 1st January 1980 to prevent configuration flip flopping,
   and added note to configuration README to advise always supplying a date, and not just a time.
   Fixes [Issue #148](https://github.com/dsccommunity/ComputerManagementDsc/issues/148).
   Fixes [Issue #411](https://github.com/dsccommunity/ComputerManagementDsc/issues/411).
 - Added examples & note to configuration README to supply a timezone when using SynchronizeAcrossTimeZone.
 - Allow SynchronizeAcrossTimeZone to be used when adding ScheduleType triggers other than 'Once',
   'Daily' and 'Weekly'.
 - Updated Delay parameter to support ScheduleType AtLogon, AtStartup, AtCreation, OnSessionState.
   Fixes [Issue #345](https://github.com/dsccommunity/ComputerManagementDsc/issues/345).
 - Updated User parameter for use with ScheduleType OnSessionState in addition to AtLogon.
 - Updated integration tests to ensure resource and configuration names are matching.
- Converted tests to Pester 5
- Rename Delete-ADSIObject to Delete-ADSIObject to satisfy HQRM
- No longer uses alias `New-InvalidArgumentException` but instead `New-ArgumentException`

### Removed

- Removed `Get-InvalidOperationRecord` to use version provided by `DscResource.Test`

FileList

Version History

Version Downloads Last updated
10.0.0 50,517 1/25/2025
10.0.0-previ... (current version) 3 1/25/2025
10.0.0-previ... 3 1/25/2025
10.0.0-previ... 254 11/15/2024
10.0.0-previ... 50 10/30/2024
10.0.0-previ... 18 10/22/2024
10.0.0-previ... 17 10/16/2024
9.2.1-previe... 29 9/30/2024
9.2.0 268,580 9/30/2024
9.2.0-previe... 73 8/31/2024
9.1.1-previe... 366 6/6/2024
9.1.0 243,693 4/30/2024
9.1.0-previe... 30 4/24/2024
9.1.0-previe... 522 12/4/2023
9.1.0-previe... 810 7/17/2023
9.1.0-previe... 478 3/10/2023
9.0.1-previe... 77 2/25/2023
9.0.0 2,181,857 2/22/2023
9.0.0-previe... 486 12/11/2022
8.6.0-previe... 96 11/23/2022
8.6.0-previe... 91 11/7/2022
8.6.0-previe... 718 6/2/2022
8.6.0-previe... 85 5/27/2022
8.5.0 5,887,889 9/13/2021
8.5.0-previe... 1,547 4/15/2021
8.4.1-previe... 474 2/12/2021
8.4.1-previe... 86 2/8/2021
8.4.1-previe... 457 8/5/2020
8.4.0 447,615 8/3/2020
8.4.0-previe... 144 7/4/2020
8.3.0 17,402 6/30/2020
8.3.0-previe... 70 6/26/2020
8.2.1-previe... 172 5/14/2020
8.2.0 37,523 5/5/2020
8.1.0 19,935 3/26/2020
8.1.0-previe... 79 3/25/2020
8.1.0-previe... 69 3/24/2020
8.0.0 43,690 2/14/2020
8.0.0-previe... 70 2/14/2020
8.0.0-previe... 81 2/8/2020
7.1.0.0 87,592 10/30/2019
7.0.0.0 25,941 9/19/2019
6.5.0.0 21,708 8/8/2019
6.4.0.0 44,353 5/15/2019
6.3.0.0 26,138 4/3/2019
6.2.0.0 56,814 2/20/2019
6.1.0.0 12,888 1/10/2019
6.0.0.0 10,896 10/25/2018
5.2.0.0 15,359 7/25/2018
5.1.0.0 34,904,143 6/13/2018
5.0.0.0 5,752 5/3/2018
Show more