Stop-Service

Para um ou mais serviços em execução.

Sintaxe

Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Stop-Service envia uma mensagem de parada para o Windows Service Controller para cada um dos serviços especificados. É possível especificar os serviços por seus nomes ou por seus nomes de exibição, ou usar o parâmetro InputObject para passar um objeto de serviço que represente os serviços que você deseja parar.

Parâmetros

-DisplayName <string[]>

Especifica os nomes de exibição dos serviços a serem parados. Os caracteres curinga são permitidos.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Exclude <string[]>

Omite os serviços especificados. O valor desse parâmetro qualifica o parâmetro Name. Digite um elemento ou padrão do nome, como "s*". Os caracteres curinga são permitidos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Force

Permite que o cmdlet pare um serviço, mesmo se aquele serviço tiver serviços dependentes.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Include <string[]>

Para somente os serviços especificados. O valor desse parâmetro qualifica o parâmetro Name. Digite um elemento ou padrão do nome, como "s*". Os caracteres curinga são permitidos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InputObject <ServiceController[]>

Especifica os objetos ServiceController que representam os serviços que devem ser parados. Insira uma variável que contenha os objetos ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Name <string[]>

Especifica os nomes dos serviços a serem parados. Os caracteres curinga são permitidos.

O nome do parâmetro é opcional. Você pode usar "Name", ou seu alias, "ServiceName", ou omitir o nome do parâmetro.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

-PassThru

Retorna um objeto que representa o serviço. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	System.ServiceProcess.ServiceController or System.String Você pode enviar um objeto de serviço ou uma cadeia de caracteres que contém o nome de um serviço para Stop-Service.
Saídas	Nenhum ou System.ServiceProcess.ServiceController Quando você usa o parâmetro PassThru, o Stop-Service gera um objeto System.ServiceProcess.ServiceController que representa o serviço. Caso contrário, esse cmdlet não gera nenhuma saída.

Observações

Você também pode fazer referência a Stop-Service usando seu alias interno, "spsv". Para obter mais informações, consulte about_Aliases.

Stop-Service poderá controlar os serviços somente quando o usuário atual tiver permissão para isso. Se um comando não funcionar corretamente, talvez você não tenha as permissões necessárias.

Para encontrar os nomes de serviços e os nomes de exibição dos serviços no seu sistema, digite "Get-Service". Os nomes de serviços são exibidos na coluna Name e os nomes de exibição na coluna DisplayName.

Exemplo 1

C:\PS>stop-service sysmonlog

Descrição
-----------
Esse comando para o serviço Logs e alertas de desempenho (SysmonLog) no computador local.

Exemplo 2

C:\PS>get-service -displayname telnet | stop-service

Descrição
-----------
Esse comando para o serviço Telnet no computador local. O comando usa o cmdlet Get-Service para obter um objeto que represente o serviço Telnet. O operador de pipeline (|) envia o objeto para o cmdlet Stop-Service, que para o serviço.

Exemplo 3

C:\PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

Descrição
-----------
O comando Stop-Service para o serviço IISAdmin no computador local. Como a interrupção desse serviço também para os serviços que dependem dele, é melhor preceder o comando Stop-Service com um comando que liste os serviços que dependem de IISAdmin.

O primeiro comando lista os serviços que dependem de IISAdmin. Ele usa o cmdlet Get-Service para obter um objeto que representa o serviço IISAdmin. O operador de pipeline (|) transmite o resultado para o cmdlet Format-List. O comando usa o parâmetro Property de Format-List para listar somente as propriedades Name e DependentServices do serviço.

O segundo comando para o serviço IISAdmin. O comando Force é necessário para parar um serviço que tenha serviços dependentes. O comando usa o parâmetro Confirm para solicitar uma confirmação do usuário antes de parar cada serviço.

Consulte também

Conceitos

Get-Service
Suspend-Service
Start-Service
Restart-Service
Resume-Service
Set-Service
New-Service