Partilhar via


Remove-Service

Remove um serviço do Windows.

Sintaxe

Name (Predefinição)

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

InputObject

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

Description

O cmdlet Remove-Service remove um serviço do Windows no Registro e no banco de dados do 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 confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

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

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

Propriedades dos parâmetros

Tipo:ServiceController
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputObject
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:True
NãoMostrar:False
Aliases:NomeDoServiço, SN

Conjuntos de parâmetros

Name
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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

Este cmdlet não retorna nenhuma saída.

Notas

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

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