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.