Windows settings time

.github/actions/spelling/expect/generic_terms.txt

@@ -18,4 +18,6 @@ sortby
 ssh
 usr
 versioning
-VGpu
+VGpu
+Ntp
+Systray

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.Time/Clock.md

@@ -0,0 +1,44 @@
+---
+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: Clock
+---
+
+# Clock
+
+## SYNOPSIS
+
+The `Clock` DSC Resource allows you to manage the system tray date/time visibility settings on a Windows machine.
+
+## DESCRIPTION
+
+The `Clock` DSC Resource allows you to manage the system tray date/time visibility settings on a Windows machine.
+
+## 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                |
+| `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`  |
+| `NotifyClockChangeProperty` | Optional      | Boolean      | Whether to notify the user when the time changes. The value should be a boolean.                                   | `$true`, `$false`  |
+
+## EXAMPLES
+
+### EXAMPLE 1 - Get the current clock settings
+
+```powershell
+C:\> Invoke-DscResource -Name Clock -Method Get -Property {}
+
+# This example gets the current clock settings on the machine.
+```
+
+### EXAMPLE 2 - Set system tray date and notify clock change
+
+```powershell
+Invoke-DscResource -Name Clock -Method Set -Property @{ ShowSystemTrayDateTime = $true; NotifyClockChange = $true }
+
+# This example sets the system tray date/time visibility settings on the machine.
+```

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

@@ -0,0 +1,45 @@
+---
+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      | Whether to set the time zone automatically. The value should be a boolean. You can find the setting in `Settings -> Time & Language -> Date & Time -> Set time automatically.                                       |     `$true`, `$false`                                                              |
+| `AdjustForDayLightSaving`  | Optional      | Boolean      | Whether to adjust for daylight saving time. The value should be a boolean. You can find the setting in `Settings -> Time & Language -> Date & Time -> Adjust for daylight saving time automatically. | `$true`, `$false` |
+
+
+## EXAMPLES
+
+### EXAMPLE 1 - Set time zone to Pacific Standard Time
+
+```powershell
+Invoke-DscResource -Name Time -Method Set -Property @{ TimeZone = "Pacific Standard Time"}
+
+# This example sets the time zone to Pacific Standard Time.
+```
+
+### EXAMPLE 2
+
+```powershell
+Invoke-DscResource -Name Time -Method Get -Property {}
+
+# This example gets the current time settings on the machine.
+```

resources/Microsoft.Windows.Setting.Time/Microsoft.Windows.Setting.Time.psd1

@@ -0,0 +1,131 @@
+#
+# Module manifest for module 'Microsoft.Windows.Setting.Time'
+#
+# Generated by: Microsoft Corporation
+#
+# Generated on: 05/11/2024
+#
+
+@{
+
+    # Script module or binary module file associated with this manifest.
+    RootModule           = 'Microsoft.Windows.Setting.Time.psm1'
+
+    # Version number of this module.
+    ModuleVersion        = '0.1.0'
+
+    # Supported PSEditions
+    # CompatiblePSEditions = @()
+
+    # ID used to uniquely identify this module
+    GUID                 = '6a947f86-eb17-46a4-9b0d-9f757b19c29a'
+
+    # 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 Time Settings'
+
+    # 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 = @('TimeZone', 'Clock')
+
+    # 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_TimeZone', 'PSDscResource_Clock')
+
+            # 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 = ''
+}
+