Windows settings language

.github/actions/spelling/allow.txt

@@ -37,3 +37,19 @@ uilt
 Windo
 ELSPROBLEMS
 requ
+whatif
+pscustomobject
+itsdangerouss
+itsdangerouss
+Bandwith
+PCs
+wmiprvse
+Workaround
+Belarus
+FLE
+GTB
+Marquesas
+Myanmar
+Systray
+timezones
+Ulaanbaatar

CONTRIBUTING.md

@@ -109,14 +109,31 @@ Once the team have approved an issue/spec, development can proceed. If no develo
 
 ### Fork, Clone, Branch and Create your PR
 
-Once you've discussed your proposed feature/fix/etc. with a team member, and you've agreed an approach or a spec has been written and approved, it's time to start development:
+Once you've discussed your proposed feature/fix/etc. with a team member, and you've agreed an approach or a spec has been written and approved, it's time to start development. There are two flows you can follow depending on the proposed feature or fix.
+
+If you're feature (or module) has not yet been created, follow these steps:
+
+1. Fork the repository if you haven't already.
+2. Clone your fork locally.
+3. Dot-source the `New-DscResourceModule.ps` in your PowerShell session.
+4. Create a new module scaffolding by executing: `New-DscResourceModule -DscResourceModule '<moduleName>' -Description 'DSC Resource for <description>'`
+5. Work on your changes and write tests.
+6. Build and test to see if it works.
+7. Create & push a feature branch.
+8. Create a [Draft Pull Request (PR)](https://github.blog/2019-02-14-introducing-draft-pull-requests/).
+9. If you are finished with your changes and you want a review, change the state.
+
+> [!TIP]
+> Don't forget to add the `DscResourcesToExport` and `Tags`.
+
+When you are working on a fix or you want to add additional features to an existing module, you can follow the below steps:
 
 1. Fork the repository if you haven't already.
-1. Clone your fork locally.
-1. Create & push a feature branch.
-1. Create a [Draft Pull Request (PR)](https://github.blog/2019-02-14-introducing-draft-pull-requests/).
-1. Work on your changes.
-1. Build and see if it works.
+2. Clone your fork locally.
+3. Work on your fix or feature, and _optionally_ write tests
+4. Build and test to see if it works.
+5. Create & push a feature branch.
+6. Create a [Pull Request (PR)](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) when you are finished with your changes
 
 ### Testing
 
@@ -126,7 +143,8 @@ Testing is a key component in the development workflow.
 
 When you'd like the team to take a look, (even if the work is not yet fully-complete), mark the Draft PR as 'Ready For Review' so that the team can review your work and provide comments, suggestions, and request changes. It may take several cycles, but the end result will be solid, testable, conformant code that is safe for us to merge.
 
-> ⚠ Remember: **changes you make may affect both the Windows Package Manager and the schema support implemented in our validation pipelines!** Because of this, we will treat community PR's with the same level of scrutiny and rigor as commits submitted to the official Windows source by team members and partners.
+> [!CAUTION]
+> Remember: **changes you make may affect both the Windows Package Manager and the schema support implemented in our validation pipelines!** Because of this, we will treat community PR's with the same level of scrutiny and rigor as commits submitted to the official Windows source by team members and partners.
 
 ### Merge
 

resources/Help/Microsoft.VSCode.Dsc/VSCodeExtension.md

@@ -28,7 +28,7 @@ The `VSCodeExtension` DSC Resource allows you to install, update, and remove Vis
 
 ## EXAMPLES
 
-### Example 1
+### EXAMPLE 1
 
 ```powershell
 # Install the latest version of the Visual Studio Code extension 'ms-python.python'

resources/Help/Microsoft.Windows.Setting.Language/DisplayLanguage.md

@@ -0,0 +1,36 @@
+---
+external help file: Microsoft.Windows.Setting.Language.psm1-Help.xml
+Module Name: Microsoft.Windows.Setting.Language
+ms.date: 11/04/2024
+online version:
+schema: 2.0.0
+title: DisplayLanguage
+---
+
+# DisplayLanguage
+
+## SYNOPSIS
+
+The `DisplayLanguage` DSC Resource allows you to set the display language on your local Windows machine.
+
+## DESCRIPTION
+
+The `DisplayLanguage` DSC Resource allows you to set the display language on your local Windows machine.
+
+## PARAMETERS
+
+| **Parameter** | **Attribute** | **DataType** | **Description**                                                                                                                           | **Allowed Values**                                                               |
+| ------------- | ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `LocaleName`  | Mandatory     | String       | The name of the language. This is the language tag that represents the language. For example, `en-US` represents English (United States). | Use the `Get-WinUserLanguageList` to see what language pack have been installed. |
+| `Exist`       | Optional      | Boolean      | Indicates whether the language should exist. The default value is `$true`.                                                               | `$true`, `$false`                                                                |
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+$params = @{
+    LocaleName = 'en-US'
+}
+Invoke-DscResource -Name DisplayLanguage -Method Set -Property $params -ModuleName Microsoft.Windows.Setting.Language
+```

resources/Help/Microsoft.Windows.Setting.Language/Language.md

@@ -0,0 +1,36 @@
+---
+external help file: Microsoft.Windows.Setting.Language.psm1-Help.xml
+Module Name: Microsoft.Windows.Setting.Language
+ms.date: 11/04/2024
+online version:
+schema: 2.0.0
+title: Language
+---
+
+# Language
+
+## SYNOPSIS
+
+The `Language` DSC Resource allows you to install, update, and uninstall languages on your local Windows machine.
+
+## DESCRIPTION
+
+The `Language` DSC Resource allows you to install, update, and uninstall languages on your local Windows machine.
+
+## PARAMETERS
+
+| **Parameter** | **Attribute** | **DataType** | **Description**                                                                                                                           | **Allowed Values**                                                                    |
+| ------------- | ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `LocaleName`  | Mandatory     | String       | The name of the language. This is the language tag that represents the language. For example, `en-US` represents English (United States). | Use the `Get-LocaleList` function or Export() method to get a list of allowed values. |
+| `Exist`       | Optional      | Boolean      | Indicates whether the language should exist. The default value is `$true`.                                                               | `$true`, `$false`                                                                     |
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+$params = @{
+    LocaleName = 'en-US'
+}
+Invoke-DscResource -Name Language -Method Set -Property $params -ModuleName Microsoft.Windows.Setting.Language
+```

resources/Help/Microsoft.Windows.Setting.Time/Time.md

@@ -0,0 +1,53 @@
+---
+external help file: Microsoft.Windows.Setting.Time.psm1-Help.xml
+Module Name: Microsoft.Windows.Setting.Time
+ms.date: 05/11/2024
+online version:
+schema: 2.0.0
+title: Time
+---
+
+# Time
+
+## SYNOPSIS
+
+This `Time` DSC Resource allows you to manage the time zone, automatic time zone update, and system tray date/time visibility settings on a Windows machine.
+
+## DESCRIPTION
+
+This `Time` DSC Resource allows you to manage the time zone, automatic time zone update, and system tray date/time visibility settings on a Windows machine.
+
+## PARAMETERS
+
+| **Parameter**              | **Attribute** | **DataType** | **Description**                                                                                                                 | **Allowed Values**                                                |
+| -------------------------- | ------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| `TimeZone`                 | Key           | String       | Specifies the time zone to set on the machine.                                                                                  | Any valid time zone identifier from `Get-TimeZone -ListAvailable` |
+| `SetTimeZoneAutomatically` | Optional      | Boolean      | The method to use to set the time zone automatically. The value should be either `NTP` or `NoSync`. The default value is `NTP`. | `NTP`, `NoSync`                                                   |
+| `ShowSystemTrayClock`      | Optional      | Boolean      | Whether to show the date and time in the system tray. The value should be a boolean. The default value is `$true`.              | `$true`, `$false`                                                 |
+
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+Invoke-DscResource -Name Time -Method Set -Property @{ TimeZone = "Pacific Standard Time"; SetTimeZoneAutomatically = "NTP"; ShowSystemTrayDateTime = $true }
+
+# This example sets the time zone to Pacific Standard Time, sets the time zone to be updated automatically using NTP, and shows the date and time in the system tray.
+```
+
+### EXAMPLE 2
+
+```powershell
+Invoke-DscResource -Name Time -Method Get -Property {}
+
+# This example gets the current time settings on the machine.
+```
+
+### EXAMPLE 3
+
+```powershell
+Invoke-DscResource -Name Time -Method Test -Property @{ TimeZone = "Pacific Standard Time"}
+
+# This example tests whether the time zone is set to Pacific Standard Time.
+```

resources/Help/Microsoft.Windows.Setting.WindowsUpdate/WindowsUpdate.md

@@ -0,0 +1,50 @@
+---
+external help file: Microsoft.Windows.Setting.Update.psm1-Help.xml
+Module Name: Microsoft.Windows.Setting.Update
+ms.date: 11/04/2024
+online version:
+schema: 2.0.0
+title: WindowsUpdate
+---
+
+# WindowsUpdate
+
+## SYNOPSIS
+
+The `WindowsUpdate` DSC resource allows you to configure various Windows Update settings, including enabling or disabling specific update services, setting download and upload rates, and configuring active hours for updates.
+
+## DESCRIPTION
+
+The `WindowsUpdate` DSC resource allows you to configure various Windows Update settings, including enabling or disabling specific update services, setting download and upload rates, and configuring active hours for updates.
+
+## PARAMETERS
+
+| **Parameter**                                      | **Attribute** | **DataType** | **Description**                                                                  | **Allowed Values**                              |
+| -------------------------------------------------- | ------------- | ------------ | -------------------------------------------------------------------------------- | ----------------------------------------------- |
+| `SID`                                              | Key           | String       | The security identifier. This is a key property and should not be set manually.  | N/A                                             |
+| `IsContinuousInnovationOptedIn`                    | Optional      | Boolean      | Indicates whether the device is opted in to continuous innovation updates.       | `$true`, `$false`                               |
+| `AllowMUUpdateService`                             | Optional      | Boolean      | Allows updates from Microsoft Update service.                                    | `$true`, `$false`                               |
+| `IsExpedited`                                      | Optional      | Boolean      | Indicates whether updates should be expedited.                                   | `$true`, `$false`                               |
+| `AllowAutoWindowsUpdateDownloadOverMeteredNetwork` | Optional      | Boolean      | Allows automatic Windows Update downloads over metered networks.                 | `$true`, `$false`                               |
+| `RestartNotificationsAllowed`                      | Optional      | Boolean      | Allows restart notifications for updates.                                        | `$true`, `$false`                               |
+| `SmartActiveHoursState`                            | Optional      | String       | Configures smart active hours state for updates.                                 | `Enabled`, `Disabled`                           |
+| `UserChoiceActiveHoursEnd`                         | Optional      | Integer      | Specifies the end time for user-chosen active hours in `HH:MM` format.           | Any valid time in `HH:MM` format                |
+| `UserChoiceActiveHoursStart`                       | Optional      | Integer      | Specifies the start time for user-chosen active hours in `HH:MM` format.         | Any valid time in `HH:MM` format                |
+| `DownloadMode`                                     | Optional      | Integer      | Specifies the download mode for updates.                                         | `Foreground`, `Background`, `Bypass`, `None`    |
+| `DownloadRateBackgroundBps`                        | Optional      | Integer      | Specifies the background download rate for updates in Bps.                       | Any positive integer value. E.g. 20000 is 2MBPs |
+| `DownloadRateForegroundBps`                        | Optional      | Integer      | Specifies the foreground download rate for updates in Bps.                       | Any positive integer value                      |
+| `DownloadRateBackgroundPct`                        | Optional      | Integer      | Specifies the background download rate for updates as a percentage of bandwidth. | 0-100                                           |
+| `DownloadRateForegroundPct`                        | Optional      | Integer      | Specifies the foreground download rate for updates as a percentage of bandwidth. | 0-100                                           |
+| `UploadLimitGBMonth`                               | Optional      | Integer      | Specifies the upload limit for updates in GB per month.                          | 5-500                                           |
+| `UpRatePctBandwidth`                               | Optional      | Integer      | Specifies the upload rate as a percentage of bandwidth.                          | 0-100                                           |
+
+## EXAMPLES
+
+### EXAMPLE 1
+
+```powershell
+$params = @{}
+Invoke-DscResource -Name WindowsUpdate -Method Set -Property $params -ModuleName Microsoft.Windows.Setting.WindowsUpdate
+
+# This command gets the current Windows Update settings.
+```

resources/Microsoft.Windows.Setting.Language/Microsoft.Windows.Setting.Language.psd1

@@ -0,0 +1,135 @@
+#
+# Module manifest for module 'Microsoft.Windows.Setting.Language'
+#
+# Generated by: Microsoft Corporation
+#
+# Generated on: 04/11/2024
+#
+
+@{
+
+    # Script module or binary module file associated with this manifest.
+    RootModule           = 'Microsoft.Windows.Setting.Language.psm1'
+
+    # Version number of this module.
+    ModuleVersion        = '0.1.0'
+
+    # Supported PSEditions
+    # CompatiblePSEditions = @()
+
+    # ID used to uniquely identify this module
+    GUID                 = '6ab8bbf6-ce28-4d33-a3ce-04c1cc16f139'
+
+    # Author of this module
+    Author               = 'Microsoft Corporation'
+
+    # Company or vendor of this module
+    CompanyName          = 'Microsoft Corporation'
+
+    # Copyright statement for this module
+    Copyright            = '(c) Microsoft Corporation. All rights reserved.'
+
+    # Description of the functionality provided by this module
+    Description          = 'DSC Resource for Windows Setting Language'
+
+    # Minimum version of the PowerShell engine required by this module
+    PowerShellVersion    = '7.2'
+
+    # Name of the PowerShell host required by this module
+    # PowerShellHostName = ''
+
+    # Minimum version of the PowerShell host required by this module
+    # PowerShellHostVersion = ''
+
+    # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # DotNetFrameworkVersion = ''
+
+    # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # ClrVersion = ''
+
+    # Processor architecture (None, X86, Amd64) required by this module
+    # ProcessorArchitecture = ''
+
+    # Modules that must be imported into the global environment prior to importing this module
+    # RequiredModules = @()
+
+    # Assemblies that must be loaded prior to importing this module
+    # RequiredAssemblies = @()
+
+    # Script files (.ps1) that are run in the caller's environment prior to importing this module.
+    # ScriptsToProcess = @()
+
+    # Type files (.ps1xml) to be loaded when importing this module
+    # TypesToProcess = @()
+
+    # Format files (.ps1xml) to be loaded when importing this module
+    # FormatsToProcess = @()
+
+    # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+    # NestedModules = @()
+
+    # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+    FunctionsToExport    = '*'
+
+    # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+    CmdletsToExport      = '*'
+
+    # Variables to export from this module
+    VariablesToExport    = '*'
+
+    # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+    AliasesToExport      = '*'
+
+    # DSC resources to export from this module
+    DscResourcesToExport = @("Language", "DisplayLanguage")
+
+    # List of all modules packaged with this module
+    # ModuleList = @()
+
+    # List of all files packaged with this module
+    # FileList = @()
+
+    # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+    PrivateData          = @{
+
+        PSData = @{
+
+            # Tags applied to this module. These help with module discovery in online galleries.
+            Tags       = @(
+                'PSDscResource_Language',
+                'PSDscResource_DisplayLanguage'
+            )
+
+            # A URL to the license for this module.
+            LicenseUri = 'https://github.com/microsoft/winget-dsc/blob/main/LICENSE'
+
+            # A URL to the main website for this project.
+            ProjectUri = 'https://github.com/microsoft/winget-dsc'
+
+            # A URL to an icon representing this module.
+            # IconUri = ''
+
+            # ReleaseNotes of this module
+            # ReleaseNotes = ''
+
+            # Prerelease string of this module
+            Prerelease = 'alpha'
+
+            # Flag to indicate whether the module requires explicit user acceptance for install/update/save
+            # RequireLicenseAcceptance = $false
+
+            # External dependent modules of this module
+            # ExternalModuleDependencies = @()
+
+        } # End of PSData hashtable
+
+    } # End of PrivateData hashtable
+
+    # HelpInfo URI of this module
+    # HelpInfoURI = ''
+
+    # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+    # DefaultCommandPrefix = ''
+
+}
+