Share via

Remove-Service

  • Reference
Module:
Microsoft.PowerShell.Management

Removes a Windows service.

Syntax

Remove-Service
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Service
      [-InputObject <ServiceController>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-Service cmdlet removes a Windows service in the registry and in the service database.

The Remove-Service cmdlet was introduced in PowerShell 6.0.

Examples

Example 1: Remove a service

This removes a service named TestService.

Remove-Service -Name "TestService"

Example 2: Remove a service using the display name

This example removes a service named TestService. The command uses Get-Service to get an object that represents the TestService service using the display name. The pipeline operator (|) pipes the object to Remove-Service, which removes the service.

Get-Service -DisplayName "Test Service" | Remove-Service

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies ServiceController objects that represent the services to remove. Enter a variable that contains the objects, or type a command or expression that gets the objects.

The InputObject parameter doesn't enumerate collections. If a collection is passed, an error is thrown. When working with collections, pipe the input to enumerate the values.

Type:ServiceController
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the service names of the services to remove. Wildcard characters are permitted.

Type:String
Aliases:ServiceName, SN
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.ServiceProcess.ServiceController, System.String

You can pipe a service object or a string that contains the name of a service to this cmdlet.

Outputs

None

This cmdlet does not return any output.

Notes

This cmdlet is only available on Windows platforms.

To run this cmdlet, start PowerShell by using the Run as administrator option.