Incorrect documentation for New-CMSoftwareUpdateDeployment -RestartServer/-RestartWorkstation

[rably1960]

This is regarding the documentation of the -RestartServer/-RestartWorksation parameters. The documentation says "Indicates whether to allow a workstation to restart following a software update". However, it actually indicates whether to suppress a reboot, not allow a reboot. A value of "true" will set the "suppressreboot" attribute bit, while a value of "false" will not set the bit. For example, setting both of these to true sets the SuppressReboot value to 3, and if you look at the deployment in SCCM after creation the suppress server and workstation boxes are both checked. So setting these to "false" will actually ALLOW a reboot.

In reality, it is either a poorly named parameter or a bug in the code for the cmdlet. But that makes it even more important to correct the documentation because this can cause servers to restart unintentionally.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 2e8e946f-57a5-6990-cfb5-f3e08fbf0e31
• Version Independent ID: 9f3e914b-9e41-7e98-a7f1-f01c31b881ab
• Content: New-CMSoftwareUpdateDeployment (ConfigurationManager) - Configuration Manager
• Content Source: sccm-ps/ConfigurationManager/New-CMSoftwareUpdateDeployment.md
• Product: configuration-manager
• Technology: configmgr-other
• GitHub Login: @aczechowski
• Microsoft Alias: aaroncz

[aczechowski]

Hi @rably thanks for the feedback. We have limited resources to maintain the over 1100 cmdlet articles for this module (along with the 3200 articles in ConfigMgr core docs). Starting with version 2002, the article for any new cmdlet should be mostly complete. We have an internal tracking item to go back and pick up older cmdlet articles when we have time, but it's honestly not our highest priority due to relatively low page views.

We rely on community support from members like you to assist. For more information, see How to contribute.

I'm updating content for the 2203 current branch release, and will try to address this article at the same time.