DSC: Deprecate xPendingReboot, renamed PendingReboot and moved to ComputerManagementDsc (#4824)

* Deprecate-xPendingReboot

* Align bold style to document standard

Author: PlagueHO

dsc/configurations/reboot-a-node.md

@@ -13,8 +13,9 @@ title:  Reboot a Node
 
 Nodes can be rebooted from within a resource, by using the `$global:DSCMachineStatus` flag. Setting
 this flag to `1` in the `Set-TargetResource` function forces the LCM to reboot the Node directly
-after the **Set** method of the current resource. Using this flag, the **xPendingReboot** resource
-detects if a reboot is pending outside of DSC.
+after the **Set** method of the current resource. Using this flag, the **PendingReboot** resource
+in the [ComputerManagementDsc](https://github.com/PowerShell/ComputerManagementDsc) DSC Resource
+module detects if a reboot is pending outside of DSC.
 
 Your [configurations](configurations.md) may perform steps that require the Node to reboot. This
 could include things such as:
@@ -24,8 +25,8 @@ could include things such as:
 - File renames
 - Computer rename
 
-The **xPendingReboot** resource checks specific computer locations to determine if a reboot is
-pending. If the Node requires a reboot outside of DSC, the **xPendingReboot** resource sets the
+The **PendingReboot** resource checks specific computer locations to determine if a reboot is
+pending. If the Node requires a reboot outside of DSC, the **PendingReboot** resource sets the
 `$global:DSCMachineStatus` flag to `1` forcing a reboot and resolving the pending condition.
 
 > [!NOTE]
@@ -35,7 +36,7 @@ pending. If the Node requires a reboot outside of DSC, the **xPendingReboot** re
 ## Syntax
 
 ```
-xPendingReboot [String] #ResourceName
+PendingReboot [String] #ResourceName
 {
     Name = [string]
     [DependsOn = [string[]]]
@@ -63,8 +64,9 @@ xPendingReboot [String] #ResourceName
 
 ## Example
 
-The following example installs Microsoft Exchange using the [xExchange](https://github.com/PowerShell/xExchange) resource.
-Throughout the install, the **xPendingReboot** resource is used to reboot the Node.
+The following example installs Microsoft Exchange using the [xExchange](https://github.com/PowerShell/xExchange)
+resource.
+Throughout the install, the **PendingReboot** resource is used to reboot the Node.
 
 > [!NOTE]
 > This example requires the credential of an account that has rights to add an Exchange server to
@@ -93,7 +95,7 @@ Configuration Example
     )
 
     Import-DscResource -Module xExchange
-    Import-DscResource -Module xPendingReboot
+    Import-DscResource -Module ComputerManagementDsc
 
     Node $AllNodes.NodeName
     {
@@ -108,7 +110,7 @@ Configuration Example
         }
 
         # Check if a reboot is needed before installing Exchange
-        xPendingReboot BeforeExchangeInstall
+        PendingReboot BeforeExchangeInstall
         {
             Name       = 'BeforeExchangeInstall'
             DependsOn  = '[File]ExchangeBinaries'
@@ -120,11 +122,11 @@ Configuration Example
             Path       = 'C:\Binaries\E15CU6\Setup.exe'
             Arguments  = '/mode:Install /role:Mailbox /Iacceptexchangeserverlicenseterms'
             Credential = $ExchangeAdminCredential
-            DependsOn  = '[xPendingReboot]BeforeExchangeInstall'
+            DependsOn  = '[PendingReboot]BeforeExchangeInstall'
         }
 
         # See if a reboot is required after installing Exchange
-        xPendingReboot AfterExchangeInstall
+        PendingReboot AfterExchangeInstall
         {
             Name      = 'AfterExchangeInstall'
             DependsOn = '[xExchInstall]InstallExchange'
@@ -139,7 +141,8 @@ Configuration Example
 
 ## Where to Download
 
-You can download the resources used in this topic at the following locations, or by using the PowerShell gallery.
+You can download the resources used in this topic at the following locations, or by using the
+PowerShell gallery.
 
-- [xPendingReboot](https://github.com/PowerShell/xPendingReboot)
+- [ComputerManagementDsc](https://github.com/PowerShell/ComputerManagementDsc)
 - [xExchange](https://github.com/PowerShell/xExchange)

dsc/managing-nodes/metaConfig.md

@@ -83,7 +83,7 @@ The following properties are available in a **Settings** block.
 | ConfigurationMode| string | Specifies how the LCM actually applies the configuration to the target nodes. Possible values are __"ApplyOnly"__,__"ApplyAndMonitor"__, and __"ApplyAndAutoCorrect"__. <ul><li>__ApplyOnly__: DSC applies the configuration and does nothing further unless a new configuration is pushed to the target node or when a new configuration is pulled from a service. After initial application of a new configuration, DSC does not check for drift from a previously configured state. Note that DSC will attempt to apply the configuration until it is successful before __ApplyOnly__ takes effect. </li><li> __ApplyAndMonitor__: This is the default value. The LCM applies any new configurations. After initial application of a new configuration, if the target node drifts from the desired state, DSC reports the discrepancy in logs. Note that DSC will attempt to apply the configuration until it is successful before __ApplyAndMonitor__ takes effect.</li><li>__ApplyAndAutoCorrect__: DSC applies any new configurations. After initial application of a new configuration, if the target node drifts from the desired state, DSC reports the discrepancy in logs, and then re-applies the current configuration.</li></ul>|
 | ConfigurationModeFrequencyMins| UInt32| How often, in minutes, the current configuration is checked and applied. This property is ignored if the ConfigurationMode property is set to ApplyOnly. The default value is 15.|
 | DebugMode| string| Possible values are __None__, __ForceModuleImport__, and __All__. <ul><li>Set to __None__ to use cached resources. This is the default and should be used in production scenarios.</li><li>Setting to __ForceModuleImport__, causes the LCM to reload any DSC resource modules, even if they have been previously loaded and cached. This impacts the performance of DSC operations as each module is reloaded on use. Typically you would use this value while debugging a resource</li><li>In this release, __All__ is same as __ForceModuleImport__</li></ul> |
-| RebootNodeIfNeeded| bool| Set this to `$true` to allow resources to reboot the Node using the `$global:DSCMachineStatus` flag. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is `$false`. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the [xPendingReboot](https://github.com/powershell/xpendingreboot) module.|
+| RebootNodeIfNeeded| bool| Set this to `$true` to allow resources to reboot the Node using the `$global:DSCMachineStatus` flag. Otherwise, you will have to manually reboot the node for any configuration that requires it. The default value is `$false`. To use this setting when a reboot condition is enacted by something other than DSC (such as Windows Installer), combine this setting with the __PendingReboot__ resource in the [ComputerManagementDsc](https://github.com/PowerShell/ComputerManagementDsc) module.|
 | RefreshMode| string| Specifies how the LCM gets configurations. The possible values are __"Disabled"__, __"Push"__, and __"Pull"__. <ul><li>__Disabled__: DSC configurations are disabled for this node.</li><li> __Push__: Configurations are initiated by calling the [Start-DscConfiguration](/powershell/module/psdesiredstateconfiguration/start-dscconfiguration) cmdlet. The configuration is applied immediately to the node. This is the default value.</li><li>__Pull:__ The node is configured to regularly check for configurations from a pull service or SMB path. If this property is set to __Pull__, you must specify an HTTP (service) or SMB (share) path in a __ConfigurationRepositoryWeb__ or __ConfigurationRepositoryShare__ block.</li></ul>|
 | RefreshFrequencyMins| Uint32| The time interval, in minutes, at which the LCM checks a pull service to get updated configurations. This value is ignored if the LCM is not configured in pull mode. The default value is 30.|
 | ReportManagers| CimInstance[]| Obsolete. Use __ReportServerWeb__ blocks to define an endpoint to send reporting data to a pull service.|