Stop-Service
Interrompe um ou mais serviços em execução.
Sintaxe
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Stop-Service
envia uma mensagem de parada para o Controlador de Serviço do Windows para cada um dos serviços especificados. Você pode especificar os serviços por seus nomes de serviço ou nomes de exibição ou pode usar o parâmetro InputObject para passar um objeto de serviço que representa o serviço que você deseja parar.
Exemplos
Exemplo 1: Parar um serviço no computador local
PS C:\> Stop-Service -Name "sysmonlog"
Esse comando interrompe o serviço SysmonLog (Logs de Desempenho e Alertas) no computador local.
Exemplo 2: parar um serviço usando o nome de exibição
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Esse comando interrompe o serviço Telnet no computador local. O comando usa Get-Service
para obter um objeto que representa o serviço Telnet. O operador de pipeline (|
) canaliza o objeto para Stop-Service
, o que interrompe o serviço.
Exemplo 3: parar um serviço que tem serviços dependentes
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
Este exemplo interrompe o serviço IISAdmin no computador local. Como parar esse serviço também interrompe os serviços que dependem do serviço IISAdmin, é melhor preceder Stop-Service
com um comando que lista os serviços que dependem do serviço IISAdmin.
O primeiro comando lista os serviços que dependem do IISAdmin. Ele usa Get-Service
para obter um objeto que representa o serviço IISAdmin. O operador de pipeline (|
) passa o resultado para o cmdlet Format-List
. O comando usa o parâmetro propriedade de Format-List
para listar apenas as propriedades Name e DependentServices do serviço.
O segundo comando interrompe o serviço IISAdmin. O parâmetro Force é necessário para interromper um serviço que tenha serviços dependentes. O comando usa o parâmetro Confirme para solicitar confirmação do usuário antes de interromper cada serviço.
Parâmetros
-Confirm
Solicita a 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 |
-DisplayName
Especifica os nomes de exibição dos serviços a serem interrompidos. Caracteres curinga são permitidos.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-Exclude
Especifica os serviços que esse cmdlet omite. O valor desse parâmetro qualifica o parâmetro Name. Insira um elemento ou padrão de nome, como s*. Caracteres curinga são permitidos.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-Force
Força o cmdlet a interromper um serviço mesmo que esse serviço tenha serviços dependentes.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Include
Especifica os serviços parados por esse cmdlet. O valor desse parâmetro qualifica o parâmetro Name. Insira um elemento ou padrão de nome, como s*. Caracteres curinga são permitidos.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-InputObject
Especifica objetos ServiceController que representam os serviços a serem interrompidos. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtém os objetos.
Tipo: | ServiceController[] |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
Especifica os nomes de serviço dos serviços a serem interrompidos. Caracteres curinga são permitidos.
Tipo: | String[] |
Aliases: | ServiceName |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | True |
-NoWait
Indica que esse cmdlet usa a opção sem espera.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PassThru
Retorna um objeto que representa o serviço. Por padrão, esse cmdlet não gera nenhuma saída.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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
Você pode canalizar um objeto de serviço para este cmdlet.
Você pode canalizar uma cadeia de caracteres que contém o nome de um serviço para este cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto ServiceController que representa o serviço.
Observações
O PowerShell inclui os seguintes aliases para Stop-Service
:
- Windows:
spsv
Esse cmdlet só está disponível em plataformas Windows.
Stop-Service
pode controlar os serviços somente quando o usuário atual tiver permissão para fazer isso. Se um comando não funcionar corretamente, talvez você não tenha as permissões necessárias.
Para localizar os nomes de serviço e os nomes de exibição dos serviços em seu sistema, digite Get-Service
. Os nomes de serviço aparecem na coluna nome do e os nomes de exibição aparecem na coluna DisplayName.