Set-Service
Starts, stops, and suspends a service, and changes its properties.
Syntax
Set-Service
[-ComputerName <String[]>]
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-Service
cmdlet changes the properties of a service such as the Status,
Description, DisplayName, and StartupType. Set-Service
can start, stop, suspend, or
pause a service. To identify a service, enter its service name or submit a service object. Or, send
a service name or service object down the pipeline to Set-Service
.
Examples
Example 1: Change a display name
In this example, a service's display name is changed. To view the original display name, use
Get-Service
.
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"
Set-Service
uses the Name parameter to specify the service's name, LanmanWorkstation. The
DisplayName parameter specifies the new display name, LanMan Workstation.
Example 2: Change the startup type of services
This example shows how to change a service's startup type.
Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status
Name StartType Status
---- --------- ------
BITS Automatic Running
Set-Service
uses the Name parameter to specify the service's name, BITS. The
StartupType parameter sets the service to Automatic.
Get-Service
uses the Name parameter to specify the BITS service and sends the object down
the pipeline. Select-Object
uses the Property parameter to display the BITS service's
status.
Example 3: Change the description of a service
This example changes the BITS service's description and displays the result.
The Get-CimInstance
cmdlet is used because it returns a Win32_Service object that includes the
service's Description.
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
disabled, then any applications that depend on BITS, such as Windows Update or MSN
Explorer, will be unable to automatically download programs and other information.
Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth.
Get-CimInstance
sends the object down the pipeline to Format-List
and displays the service's
name and description. For comparison purposes, the command is run before and after the description
is updated.
Set-Service
uses the Name parameter to specify the BITS service. The Description
parameter specifies the updated text for the services' description.
Example 4: Start a service
In this example, a service is started.
Set-Service -Name WinRM -Status Running -PassThru
Status Name DisplayName
------ ---- -----------
Running WinRM Windows Remote Management (WS-Manag...
Set-Service
uses the Name parameter to specify the service, WinRM. The Status
parameter uses the value Running to start the service. The PassThru parameter outputs a
ServiceController object that displays the results.
Example 5: Suspend a service
This example uses the pipeline to pause to service.
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service
uses the Name parameter to specify the Schedule service, and sends the object
down the pipeline. Set-Service
uses the Status parameter to set the service to Paused.
Example 6: Stop a service
This example uses a variable to stop a service.
$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped
Get-Service
uses the Name parameter to specify the service, Schedule. The object is stored
in the variable, $S
. Set-Service
uses the InputObject parameter and specifies the object
stored $S
. The Status parameter sets the service to Stopped.
Parameters
Specifies one or more computers. For remote computers, type the NetBIOS name, an IP address, or a fully qualified domain name. If the ComputerName parameter isn't specified, the command runs on the local computer.
This parameter doesn't rely on PowerShell remoting. You can use the ComputerName parameter even if your computer isn't configured to run remote commands.
Type: | String[] |
Aliases: | cn |
Position: | Named |
Default value: | Local computer |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Prompts you for confirmation before running Set-Service
.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies a new description for the service.
The service description appears in Computer Management, Services. The Description isn't a
property of the Get-Service
ServiceController object. To see the service description, use
Get-CimInstance
that returns a Win32_Service object that represents the service.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies a new display name for the service.
Type: | String |
Aliases: | DN |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies a ServiceController object that represents the service to change. Enter a variable
that contains the object, or type a command or expression that gets the object, such as a
Get-Service
command. You can use the pipeline to send a service object to Set-Service
.
Type: | ServiceController |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Specifies the service name of the service to be changed. Wildcard characters aren't permitted. You
can use the pipeline to send a service name to Set-Service
.
Type: | String |
Aliases: | ServiceName, SN |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Returns a ServiceController object that represents the services that were changed. By default,
Set-Service
doesn't generate any output.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Sets the startup type of the service. The acceptable values for this parameter are:
- Automatic - The service is started or was started by the operating system, at system start-up. If an automatically started service depends on a manually started service, the manually started service is also started automatically at system startup.
- Disabled - The service is disabled and cannot be started by a user or application.
- Manual - The service is started only manually, by a user, using the Service Control Manager, or by an application.
- Boot - Indicates that the service is a device driver started by the system loader. This value is valid only for device drivers.
- System - Indicates that the service is a device driver started by the 'IOInitSystem()' function. This value is valid only for device drivers.
The default value is Automatic.
Type: | ServiceStartMode |
Aliases: | StartMode, SM, ST |
Accepted values: | Boot, System, Automatic, Manual, Disabled |
Position: | Named |
Default value: | Automatic |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies the status for the service.
The acceptable values for this parameter are as follows:
- Paused. Suspends the service.
- Running. Starts the service.
- Stopped. Stops the service.
Type: | String |
Accepted values: | Paused, Running, Stopped |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Shows what would happen if Set-Service
runs. The cmdlet isn't run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
System.ServiceProcess.ServiceController, System.String
You can use the pipeline to send a service object or a string that contains a service name to
Set-Service
.
Outputs
By default, Set-Service
doesn't return any objects. Use the PassThru parameter to output a
ServiceController object.
Notes
Set-Service
requires elevated permissions. Use the Run as administrator option.
Set-Service
can only control services when the current user has permissions to manage services. If
a command doesn't work correctly, you might not have the required permissions.
To find a service's service name or display name, use Get-Service
. The service names are in the
Name column and the display names are in the DisplayName column.
Related Links
Feedback
Submit and view feedback for