Compartilhar via

Stop-Service

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

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

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, 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 Property 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

System.ServiceProcess.ServiceController, System.String

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

Saídas

None, System.ServiceProcess.ServiceController

Esse cmdlet gera um objeto System.ServiceProcess.ServiceController que representa o serviço, se você usar o parâmetro PassThru. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

  • Você também pode consultar stop-service por seu alias interno, spsv. Para obter mais informações, consulte about_Aliases.

    stop-service só poderá controlar os serviços 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.