Restart-Service

Restart-Service
    [-InputObject] <ServiceController[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Restart-Service
    [-Name] <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Restart-Service
    -DisplayName <String[]>
    [-Force]
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

This cmdlet is only available on the Windows platform.

The Restart-Service cmdlet sends a stop message and then a start message to the Windows Service Controller for a specified service. If a service was already stopped, it is started without notifying you of an error. You can specify the services by their service names or display names, or you can use the InputObject parameter to pass an object that represents each service that you want to restart.

PS C:\> Restart-Service -Name winmgmt

This command restarts the Windows Management Instrumentation service (WinMgmt) on the local computer.

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

This command restarts the services that have a display name that starts with Net, except for the Net Logon service.

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

This command starts all of the stopped network services on the computer.

This command uses the Get-Service cmdlet to get objects that represent the services whose service name starts with net. The pipeline operator (|) sends the services object to the Where-Object cmdlet, which selects only the services that have a status of stopped. Another pipeline operator sends the selected services to Restart-Service.

In practice, you would use the WhatIf parameter to determine the effect of the command before you run it.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

You can pipe a service object to this cmdlet.

You can pipe a string that contains a service name to this cmdlet.

By default, this cmdlet returns no output.

When you use the PassThru parameter, this cmdlet returns a ServiceController object representing the restarted service.

This cmdlet is only available on Windows platforms.

• Restart-Service can control services only when the current user has permission to do this. If a command does not work correctly, you might not have the required permissions.
• To find the service names and display names of the services on your system, type Get-Service". The service names appear in the Name column, and the display names appear in the DisplayName column.