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 string que contém o nome de um serviço para Stop-Service. |
| Saídas | None 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.