PowerShell Restart-Service Cmdlet

Windows PowerShell Restart-Service

The most efficient way for PowerShell to cure a hung service is with the verb 'restart'.  Restart-Service xyz is just simpler and more efficient than stop-Service xyz, followed by start-Service xyz.  If you are new to PowerShell Restart-Service, then I suggest that you begin with my Get-Service page.

Topics for PowerShell Restart-Service

 ♣

Example 1: How to Restart a Service

The service which benefits most from Restart-Service is, "Spooler".  The reason being the printer gives more trouble than any other piece of hardware, and often restarting the Spooler cures the problem.  The inferior, but ruthless method of curing such printer jams is to reboot the computer.  When the computer is also a fileserver, this technique is undesirable.

Production Script

All you really need is this simple command:

# PowerShell Restart-Service example
Restart-Service "Spooler"

Note 1: You can change "Spooler" to the name of another service.  To list services see PowerShell’s Get-Service

Comprehensive Restart-Service Script

# PowerShell cmdlet to restart the Spooler service
Clear-Host
$SrvName = "Spooler"
$ServicePrior = Get-Service $SrvName
"$srvName is " + $servicePrior.status
Set-Service $SrvName -startuptype manual
Restart-Service $srvName
$ServiceAfter = Get-Service $SrvName
"$SrvName is now " + $ServiceAfter.status
Set-Service $SrvName -startuptype automatic

Learning Points

Note 2: My biggest fear is that in a production script I will misspell the name of the service.  Thus, check for success by observing this system message:

WARNING: Waiting for service ‘Print Spooler (Spooler)’ to finish starting…

Note 3: There will be variations depending on which operating system you are using.

Guy Recommends:  A Free Trial of the Network Performance Monitor (NPM)Review of Orion NPM v11.5 v11.5

SolarWinds’ Network Performance Monitor will help you discover what’s happening on your network.  This utility will also guide you through troubleshooting; the dashboard will indicate whether the root cause is a broken link, faulty equipment or resource overload.

What I like best is the way NPM suggests solutions to network problems.  Its also has the ability to monitor the health of individual VMware virtual machines.  If you are interested in troubleshooting, and creating network maps, then I recommend that you try NPM now.

Download a free trial of Solarwinds’ Network Performance Monitor

Example 2: Avoid the Trap of Name or DisplayName

What’s in a Name?  What do these groups of services have in common?

Group A
Alerter, Messenger, WebClient

Group B
Print Spooler, Telnet, Telephony and Windows Time

More importantly, why won’t the PowerShell’s service family interact with Group B?

The Answer: Some services have a ‘Display Name’ which differs from their ‘Service Name’, for example Telnet and Tlnsvr.  How did I find this out?  When I tried to start ‘Telnet’, or ‘Print Spooler’, nothing happened.  Yet if I had a manual walk-through in the Service GUI, no problem.  Then I ran Get-Service * and observed the two columns, Name and also Display Name.  What threw me into confusion was Group A, where both names are the same.

Just to emphasise, if you wish to use the name ‘Print Spooler’, you need to specify the property -DisplayName.

# PowerShell Restart-Service example using displayName
Restart-Service -displayName "Print Spooler"

Note 4: You could research the names and displayNames with Get-Service.

Example 3: How to Simply Start a Windows Service

In Windows Server 2003 days I choose the Alerter service for testing, partly because it’s relatively harmless service, and partly because its name is near the top of the list!  However, since it’s been removed from Windows 7 and Server 2008 does I have chosen PLA (Performance Logs and Alerts) to test PowerShell’s service cmdlets.

Preliminary Script

Let us check the service’s status, and also let us ‘warm up’ with Get-Service before we employ other members of the service family.

# PowerShell cmdlet to check a service’s status
$srvName = "PLA"
$servicePrior = Get-Service $srvName
$srvName + " is now " + $servicePrior.status

Learning Points

Note 5: I have decided to introduce the variable $srvName to hold the value of the service.  Hopefully this will emphasise the name of the service, and prompt you to change it as necessary for your project.

Note 6: Observe how I mix the ”literal phrases” with the $variables and properties to produce a meaningful output.

Guy Recommends: SolarWinds Free Wake-On-LAN UtilitySolarwinds Wake-On-LAN

Encouraging computers to sleep when they’re not in use is a great idea – until you are away from your desk and need a file on that remote sleeping machine!

WOL also has business uses for example, rousing machines so that they can have update patches applied.  My real reason for recommending you download this free tool is because it’s so much fun sending those ‘Magic Packets’. Give WOL a try – it’s free.

Download your free copy of SolarWinds Wake-On-LAN

The Main Event – Starting PLA

Windows 7 and Server 2008 (and later) do not have an Alerter service, this is why I now use PLA (Performance Logs and Alerts) to test PowerShell’s start-Service.

# PowerShell cmdlet to start a named service
$srvName = "PLA"
$servicePrior = Get-Service $srvName
"$srvName is now " + $servicePrior.status
Set-Service $srvName -startuptype manual
Start-Service $srvName
$serviceAfter = Get-Service $srvName
"$srvName is now " + $serviceAfter.status

Learning Points

Note 7: Observe how the speech marks are slightly different in this script compared with the previous:
"$srvName is now " + $servicePrior.status
compared with
$srvName + " is now " + $servicePrior.status

My points are:
a) Experiment yourself. 
b) To some extent, these learning scripts leave traces of my thinking process.

Note 8: I prepared the above script to help you appreciate the factors needed to control a Windows Service.  It also reflects my thinking process of how I learn about a command.  On the other hand, for a production script you could take a much more ruthless approach and simplify the script thus:

Set-Service PLA -startuptype manual
Start-Service PLA

Monitor Your Network with the Real-time Traffic AnalyzerSolarwinds Real-time Traffic Analyzer

The main reason to monitor your network is to check that your all your servers are available.  If there is a network problem you want an interface to show the scope of the problem at a glance.

Even when all servers and routers are available, sooner or later you will be curious to know who, or what, is hogging your precious network’s bandwidth.  A GUI showing the top 10 users makes interesting reading.

Another reason to monitor network traffic is to learn more about your server’s response times and the use of resources.  To take the pain out of capturing frames and analysing the raw data, Guy recommends that you download a copy of the SolarWindsfree Real-time NetFlow Analyzer.

Example 4: How to Stop a Service

In real life, you may want a script which ensures that services such as: Telnet, Messenger and Routing and Remote Access are Stopped.  Just for testing, you may need a script which reverses start-Service, just to be sure that it really is working as designed.  Either way, here is a script which stops the service defined by $srvName.

# PowerShell cmdlet to stop the Plug & Play service
$srvName = "PLA"
$servicePrior = Get-Service $srvName
"$srvName is now " + $servicePrior.status
stop-Service $srvName
$serviceAfter = Get-Service $srvName
set-Service $srvName -startuptype disabled
"$srvName is now " + $serviceAfter.status

Learning Points

Note 9: Observe how this script is the mirror image of the Start-Service script.  It even disables the service once it has stopped.  If you remember, when Example 1 wanted to start a service, it must first make sure the -startuptype is set to manual.

The '-Service' Family (Each member has a different verb)

Clear-Host
Get-Command -Noun Service

Get-Service:  Useful for listing the services
Set-Service:  Crucial parameter -startuptype
Start-Service:  The verb ‘start’ says it all
Stop-Service:  Handy for scripts which prevent unwanted services running e.g. Telnet
Restart-Service:  A nice touch by the creator’s of PowerShell; this cmdlet removes the need to explicitly stop then start the service.

Engineer's Toolset v10Guy Recommends: SolarWinds Engineer’s Toolset v10

This Engineer’s Toolset v10 provides a comprehensive console of 50 utilities for troubleshooting computer problems.  Guy says it helps me monitor what’s occurring on the network, and each tool teaches me more about how the underlying system operates.

There are so many good gadgets; it’s like having free rein of a sweetshop.  Thankfully the utilities are displayed logically: monitoring, network discovery, diagnostic, and Cisco tools.  Try the SolarWinds Engineer’s Toolset now!

Download your fully functional trial copy of the Engineer’s Toolset v10

Remoting with PowerShell Service

One aspect of remoting in PowerShell v 2.0 is simply to append -computerName xyz to the command that you ran on the local machine.  For further research try:

Clear-Host
Get-Command | where { $_.parameters.keys -Contains "ComputerName"}

Surprise!  Get-Service is amongst the cmdlets that support remoting, but stop, start and restart-Service are not on the list.  More bad news, stop, start and restart-Service really don’t work on network machines.  Thus you have to employ different techniques such as Get-WmiObject and InvokeMethod.  Alternatively, you could enter-PSSession and then run restart-Service as if you were on the local machine.  However, to get that working you have to first install and setup WinRM

Summary of PowerShell’s Start-Service Cmdlet

If your mission is to master the start-Service command, commence with Get-Service.  Once you have mastered the rhythm of the Get-Service Verb-Noun pair, move on to the Start, Stop, and restart-Service family of PowerShell commands.  For scripting purposes, make sure that you use the true Service Name, and avoid the Service’s Display Name.  A final piece of advice, open the Service GUI so that you can double-check that what your script is doing is what you intended.

If you like this page then please share it with your friends

 


See more PowerShell examples of process and service

PowerShell Home   • Get-Process   • Stop-Process   • PowerShell Start-Process   • Set-Service

Get-Service   • Start-Service   • Stop-Service   • Restart-Service   • Free WMI Monitor

PowerShell Start-Sleep   • Get-WmiObject win32_service   • Windows PowerShell

Please email me if you have a better example script. Also please report any factual mistakes, grammatical errors or broken links, I will be happy to correct the fault.