Client Tools: Restart SMS Agent Host Service
What it does:
The Restart SMS Agent Host Service tool allows a console user restart the ConfigMgr client on a device.
How it does it:
This tool completes this action via Remote WMI.
Navigate to the Restart SMS Agent Host Service tool by right clicking on a Device Object, selecting Recast RCT, then Client Tools, and finally selecting Restart SMS Agent Host Service.
The Restart SMS Agent Host Service tool can be run on single devices or multi-selected devices. A similar tool is also available to run on a Device Collection.
When the action is run, it kicks off the restart automatically, displaying a progress bar and status message until either a successful completion or failure message.
The Restart SMS Agent Host Service tool requires the following permissions:
- Requires the Restart SMS Agent Host Service permission in the ConfigMgr Client plugin.
- This tool requires administrator permission on the remote device. If using a Recast Server with service account, the service account needs administrator permission on the remote device.
- This tool requires remote WMI.
This tool requires Remote WMI. For more details on Remote WMI in the Right Click Tools, see our FAQ page.
If the device targeted for an SMS Agent Host Service restart is not powered on, the following error message will be displayed:
Issues with the RPC Server are displayed with an exception code: