Remove-Service

  • Referência
Módulo:
Microsoft.PowerShell.Management

Remove um serviço do Windows.

Sintaxe

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

Description

O Remove-Service cmdlet remove um serviço do Windows no registro e no banco de dados de serviço.

O cmdlet Remove-Service foi introduzido no PowerShell 6.0.

Exemplos

Exemplo 1: Remover um serviço

Isso remove um serviço chamado TestService.

Remove-Service -Name "TestService"

Exemplo 2: Remover um serviço usando o nome de exibição

Este exemplo remove um serviço chamado TestService. O comando usa Get-Service para obter um objeto que representa o serviço TestService usando o nome de exibição. O operador de pipeline (|) canaliza o objeto para Remove-Service, o que remove o serviço.

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

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica objetos ServiceController que representam os serviços a serem removidos. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém os objetos.

O parâmetro InputObject não enumera coleções. Se uma coleção for passada, um erro será gerado. Ao trabalhar com coleções, canalize a entrada para enumerar os valores.

Tipo:ServiceController
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica os nomes de serviço dos serviços a serem removidos. Caracteres curinga são permitidos.

Tipo:String
Aliases:ServiceName, SN
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

ServiceController

Você pode canalizar um objeto de serviço para esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres que contém o nome de um serviço para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

Esse cmdlet só está disponível em plataformas Windows.

Para executar esse cmdlet, inicie o PowerShell usando a opção Executar como administrador .