v1.1.0

Author: jdhitsolutions

.vscode/settings.json

@@ -1,5 +1,9 @@
 
 {
     // When enabled, will trim trailing whitespace when you save a file.
-    "files.trimTrailingWhitespace": true
+    "files.trimTrailingWhitespace": true,
+    "cSpell.words": [
+        "windowsactivehours",
+        "windowsupdatesetting"
+    ]
 }

README.md

@@ -2,26 +2,26 @@
 
 [![PSGallery Version](https://img.shields.io/powershellgallery/v/WindowsUpdateSetting.png?style=for-the-badge&label=PowerShell%20Gallery)](https://www.powershellgallery.com/packages/WindowsUpdateSetting/) [![PSGallery Downloads](https://img.shields.io/powershellgallery/dt/WindowsUpdateSetting.png?style=for-the-badge&label=Downloads)](https://www.powershellgallery.com/packages/WindowsUpdateSetting/)
 
-The PowerShell commands in this module are intended to make it easier to automate the process of pausing and resuming Windows Updates on a Windows 10 desktop as well as a few other update-related settings. This module will not work on Windows 10 Home. If you are running Windows 10 Enterprise, your settings may be managed via Group Policy, in which case you won't be able to use this module.
+The PowerShell commands in this module are intended to make it easier to automate the process of pausing and resuming Windows Updates on a Windows 10/11 desktop as well as a few other update-related settings. __This module will not work on Windows 10 Home__. If you are running an Enterprise edition of Windows, your settings may be managed via Group Policy, in which case you won't be able to use this module.
 
 You can install the latest version of this module from the PowerShell Gallery.
 
 ```powershell
-Install-Module WindowsUpdateSetting
+Install-PSResource WindowsUpdateSetting
 ```
 
 The module should work on PowerShell 7 running on a Windows platform.
 
 ## Command Overview
 
-- [Get-WindowsActiveHours](./docs/Get-WindowsActiveHours.md)
-- [Get-WindowsUpdateDeferral](./docs/Get-WindowsUpdateDeferral.md)
-- [Get-WindowsUpdateSetting](./docs/Get-WindowsUpdateSetting.md)
-- [Resume-WindowsUpdate](./docs/Resume-WindowsUpdate.md)
-- [Set-WindowsActiveHours](./docs/Set-WindowsActiveHours.md)
-- [Set-WindowsUpdateDeferral](./docs/Set-WindowsUpdateDeferral.md)
-- [Suspend-WindowsUpdate](./docs/Suspend-WindowsUpdate.md)
-- [Test-IsWindowsUpdatePaused](./docs/Test-IsWindowsUpdatePaused.md)
+- [Get-WindowsActiveHours](docs/Get-WindowsActiveHours.md)
+- [Get-WindowsUpdateDeferral](docs/Get-WindowsUpdateDeferral.md)
+- [Get-WindowsUpdateSetting](docs/Get-WindowsUpdateSetting.md)
+- [Resume-WindowsUpdate](docs/Resume-WindowsUpdate.md)
+- [Set-WindowsActiveHours](docs/Set-WindowsActiveHours.md)
+- [Set-WindowsUpdateDeferral](docs/Set-WindowsUpdateDeferral.md)
+- [Suspend-WindowsUpdate](docs/Suspend-WindowsUpdate.md)
+- [Test-IsWindowsUpdatePaused](docs/Test-IsWindowsUpdatePaused.md)
 
 ## Suspend and Resume Windows Updates
 
@@ -38,11 +38,17 @@ PS C:\> Suspend-WindowsUpdate -passthru
 
 Paused   PauseStartUTC          PauseEndUTC             TimeRemaining
 ------   -------------          -----------             -------------
-True     8/9/2023 8:27:34 PM    9/13/2023 8:27:34 PM      35.03:59:59
+True     3/18/2025 12:32:04 PM  4/22/2025 12:32:04 PM     35.03:59:59
 ```
 
 Or you can specify a date, as long as it is less than 35 days. Use `Get-WindowsUpdateSetting` to view the current values or `Test-IsWindowsUpdatePaused` to test.
 
+Updates should resume automatically at the end of the pause period. However, you can run `Resume-WindowsUpdate` to resume updates manually.
+
+```powershell
+Resume-WindowsUpdate
+```
+
 ## Configure Active Hours
 
 This module also contains commands to set your active hours.
@@ -54,7 +60,7 @@ PS C:\> Get-WindowsActiveHours
 
 Computername         Start        End
 ------------         -----        ---
-PROSPERO          06:00 AM   10:00 PM
+PROSPERO          06:00 AM   11:00 PM
 
 
 PS C:\> Set-WindowsActiveHours -StartTime 8:00 -EndTime 20:00 -Passthru
@@ -77,14 +83,18 @@ PS C:\> Get-WindowsUpdateDeferral
 
 Computername FeatureUpdateDeferral QualityUpdateDeferral
 ------------ --------------------- ---------------------
-BOVINE320                       30                     7
+PROSPERO     undefined             undefined
+```
 
+Use `Set-WindowsUpdateDeferral` to set the deferral values. You can use `-Feature` and `-Quality` to set the number of days to defer feature and quality updates, respectively.
 
-PS C:\> Set-WindowsUpdateDeferral -Feature 0 -Quality 0 -Passthru
+```powershell
+PS C:\> Set-WindowsUpdateDeferral -Feature 30 -Quality 7 -Passthru
 
 Computername FeatureUpdateDeferral QualityUpdateDeferral
 ------------ --------------------- ---------------------
-BOVINE320                       30                     7
+PROSPERO                        30                     7
 ```
 
 **You should test all of these commands on a non-production system.**
+

WindowsUpdateSetting.psd1

@@ -4,12 +4,12 @@
 
 @{
     RootModule           = 'WindowsUpdateSetting.psm1'
-    ModuleVersion        = '1.0.0'
+    ModuleVersion        = '1.1.0'
     CompatiblePSEditions = @('Desktop', 'Core')
     GUID                 = '1d09501c-fc3f-424a-9fb9-c2a5d6f59001'
     Author               = 'Jeff Hicks'
     CompanyName          = 'JDH Information Technology Solutions, Inc.'
-    Copyright            = '(c) 2018-2023 Jeff Hicks. All rights reserved.'
+    Copyright            = '(c) 2018-2025 Jeff Hicks. All rights reserved.'
     Description          = 'A set of PowerShell functions to managing Windows Update settings such as pausing, on Windows 10 or Windows 11. This module should work in Windows PowerShell and PowerShell 7 on a Windows platform.'
     PowerShellVersion    = '5.1'
     FunctionsToExport    = @(
@@ -22,7 +22,10 @@
         'Get-WindowsUpdateDeferral',
         'Set-WindowsUpdateDeferral'
     )
-    FormatsToProcess = @('formats\windowsactivehours.format.ps1xml','formats\windowsupdatesetting.format.ps1xml')
+    FormatsToProcess = @(
+        'formats\windowsactivehours.format.ps1xml',
+        'formats\windowsupdatesetting.format.ps1xml'
+        )
     CmdletsToExport      = ''
     AliasesToExport      = 'rwu', 'swu', 'gwu'
     PrivateData          = @{

WindowsUpdateSetting.psm1

@@ -1,11 +1,20 @@
-if ($ISWindows -or $PSEdition -eq 'Desktop') {
+Import-LocalizedData -BindingVariable strings
+if ($ISWindows -Or $PSEdition -eq 'Desktop') {
     Get-ChildItem -path $PSScriptRoot\functions\*.ps1 |
     ForEach-Object {
         . $_.FullName
     }
+
+    #define a module-scoped variable for the module version
+    $ModuleVersion = (Test-ModuleManifest -Path $PSScriptRoot\WindowsUpdateSetting.psd1).Version
+
+    #a module-scoped variable for the ANSI escape sequences using in custom verbose messaging
+    $VerboseAnsi = @{
+        "Default" = "[93m"
+    }
 }
 else {
     #get the module name
     $ModuleName = $MyInvocation.MyCommand.Name.split(".")[0]
-    Write-Warning "The $ModuleName module requires a Windows platform."
+    Write-Warning ($strings.RequiresWindows -f $ModuleName)
 }

changelog.md

@@ -1,6 +1,20 @@
 # Changelog for WindowsUpdateSetting
 
-## v1.0.0
+## [Unreleased]
+
+## [1.1.0] - 2025-03-18
+
+### Added
+
+- Added custom verbose messaging using localized string data.
+
+### Changed
+
+- Changed online help links.
+- Converted `Changelog` to new format.
+- Updated `README`.
+
+## [v1.0.0] - 2023-08-09
 
 ### Changed
 
@@ -14,40 +28,47 @@
 
 - Added custom format files `windowsupdatesetting.format.ps1xml` and windowsactivehours.format.ps1xml`.
 - Added missing online help links.
--
-## v0.3.2
+
+## [v0.3.2] - 2018-10-23
 
 - file cleanup for PowerShell Gallery
 - manifest update
 
-## v0.3.1
+## [v0.3.1] - 2018-09-24
 
 - Updated manifest
 - Updated help for `Suspend-WindowsUpdate` ([Issue #4](https://github.com/jdhitsolutions/WindowsUpdateSetting/issues/4))
 - Added module icon
 - Updated README
 - Added some command aliases
 
-## v0.3.0
+## [v0.3.0] - 2018-09-20
 
 - Updated ShouldProcess message on `Suspend-WindowsUpdate` ([Issue #3](https://github.com/jdhitsolutions/WindowsUpdateSetting/issues/3))
 - Added custom type names to PSCustomObject output ([Issue #2](https://github.com/jdhitsolutions/WindowsUpdateSetting/issues/2))
 - Updated README
 - Updated documentation
 
-## v0.2.1
+## v0.2.1 - 2018-09-20
 
 - Github updates
 - Updated README
 
-## v0.2.0
+## v0.2.0 - 2018-09-20
 
 - Updated manifest
 - Added functions to defer feature and quality updates
 - Added function set manage Windows Active hours
 - Modified `Suspend-WindowsUpdate` to specify a resume date.
 - Updated documentation
 
-## v0.1.0
+## v0.1.0 - 2018-09-19
 
 - initial files
+
+[Unreleased]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/v1.1.0..HEAD
+[v1.1.0]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/1.0.0..v1.1.0
+[v1.0.0]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/v0.3.2..v1.0.0
+[v0.3.2]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/0.3.1..v0.3.2
+[v0.3.1]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/0.3.0..0.3.1
+[v0.3.0]: https://github.com/jdhitsolutions/WindowsUpdateSetting/compare/0.2.1..0.3.0

docs/Get-WindowsActiveHours.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/47nMfSG
+online version: https://jdhitsolutions.com/yourls/2a97cc
 schema: 2.0.0
 ---
 
@@ -49,7 +49,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Get-WindowsUpdateDeferral.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/440sPk0
+online version: https://jdhitsolutions.com/yourls/355b5b
 schema: 2.0.0
 ---
 
@@ -49,7 +49,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Get-WindowsUpdateSetting.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/3s6oApN
+online version: https://jdhitsolutions.com/yourls/c7d249
 schema: 2.0.0
 ---
 
@@ -28,11 +28,11 @@ Display the current values for any paused Windows Update settings.
 ```powershell
 PS C:\> Get-WindowsUpdateSetting
 
-Computername  : BOVINE320
-UpdatesPaused : True
-PauseStartUTC : 9/19/2022 11:13:16 PM
-PauseEndUTC   : 10/24/2022 11:13:16 PM
-Remaining     : 34.23:55:49.1598117
+   Computername: PROSPERO
+
+Paused   PauseStartUTC          PauseEndUTC             TimeRemaining
+------   -------------          -----------             -------------
+True     3/18/2025 1:42:20 PM   4/22/2025 1:42:20 PM      35.03:59:55
 ```
 
 The settings when updates are paused.
@@ -53,7 +53,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Resume-WindowsUpdate.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/3DP7hfp
+online version: https://jdhitsolutions.com/yourls/133e47
 schema: 2.0.0
 ---
 
@@ -95,8 +95,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell:
-http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Set-WindowsActiveHours.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/3DRauLo
+online version: https://jdhitsolutions.com/yourls/4ada3f
 schema: 2.0.0
 ---
 
@@ -137,7 +137,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Set-WindowsUpdateDeferral.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/44ZqRS1
+online version: https://jdhitsolutions.com/yourls/33f459
 schema: 2.0.0
 ---
 
@@ -134,7 +134,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell: http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS
 

docs/Suspend-WindowsUpdate.md

@@ -1,7 +1,7 @@
 ---
 external help file: WindowsUpdateSetting-help.xml
 Module Name: WindowsUpdateSetting
-online version: https://bit.ly/3DQf7Wb
+online version: https://jdhitsolutions.com/yourls/22231b
 schema: 2.0.0
 ---
 
@@ -19,8 +19,7 @@ Suspend-WindowsUpdate [-Resume <DateTime>] [-Passthru] [-WhatIf] [-Confirm] [<Co
 
 ## DESCRIPTION
 
-This command achieves the same result as pausing Windows Updates in Settings/Windows Update/Advanced Settings.
-By default your system will not check or get any updates for 35 days. But you can specify a date that is less than 35 days.
+This command achieves the same result as pausing Windows Updates in Settings/Windows Update/Advanced Settings. By default your system will not check or get any updates for 35 days. But you can specify a date that is less than 35 days.
 
 ## EXAMPLES
 
@@ -39,7 +38,7 @@ PS C:\> Suspend-WindowsUpdate -passthru
 
 Paused   PauseStartUTC          PauseEndUTC             TimeRemaining
 ------   -------------          -----------             -------------
-True     8/9/2023 8:27:34 PM    9/13/2023 8:27:34 PM      35.03:59:59
+True     3/18/2025 1:42:20 PM   4/22/2025 1:42:20 PM      35.03:59:59
 ```
 
 ### EXAMPLE 3
@@ -130,8 +129,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ## NOTES
 
-Learn more about PowerShell:
-http://jdhitsolutions.com/blog/essential-powershell-resources/
+Learn more about PowerShell: https://buttondown.com/behind-the-powershell-pipeline
 
 ## RELATED LINKS