Suspend-Service
Suspende (pausa) um ou mais serviços em execução.
Sintaxe
Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrição
O cmdlet Suspend-Service envia uma mensagem de suspensão para o Windows Service Controller para cada um dos serviços especificados. Embora suspenso, o serviço ainda está em execução, mas sua ação fica interrompida até que seja reiniciada, por exemplo, usando Resume-Service. É possível especificar os serviços pelos nomes ou pelos nomes para exibição, ou usar o parâmetro InputObject para passar um objeto de serviço que represente os serviços que você deseja suspender.
Parâmetros
-DisplayName <string[]>
Especifica os nomes de exibição dos serviços a serem suspensos. 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 |
-Include <string[]>
Suspende 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 suspensos. 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 suspensos. 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 um nome de serviço para Suspend-Service. |
| Saídas | None ou System.ServiceProcess.ServiceController
Quando você usa o parâmetro PassThru, o Suspend-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
Suspend-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.
Além disso, Suspend-Service pode suspender apenas os serviços que suportam a suspensão e o reinício. Para saber se um determinado serviço pode ser suspenso, utilize o cmdlet Get-Service com a propriedade CanPauseAndContinue. Por exemplo, "Get-Service wmi | Format-List name, canpauseandcontinue". Para localizar todos os serviços no computador que podem ser suspensos, digite "Get-Service | Where-Object {$_.canpauseandcontinue -eq "True"}".
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 o nome de exibição na coluna DisplayName.
Exemplo 1
C:\PS>suspend-service -displayname "Telnet" Descrição ----------- Esse comando suspende o serviço Telnet (Tlntsvr) no computador local.
Exemplo 2
C:\PS>suspend-service -name lanman* -whatif Descrição ----------- Esse comando diz o que aconteceria se você suspendesse os serviços que têm um nome de serviço que começa com "lanman". Para suspender os serviços, execute novamente o comando sem o parâmetro WhatIf.
Exemplo 3
C:\PS>get-service schedule | suspend-service Descrição ----------- Esse comando usa o cmdlet Get-Service para obter um objeto que represente o serviço Agendador de Tarefas (Schedule) no computador. O operador de pipeline (|) transmite o resultado para o cmdlet Suspend-Service para que ele suspenda o serviço.
Exemplo 4
C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm
Descrição
-----------
Esse comando suspende todos os serviços do computador que podem ser suspensos. Ele usa o cmdlet Get-Service para obter objetos que representam os serviços no computador. O operador de pipeline (|) transmite os resultados para o cmdlet Where-Object, que seleciona somente os serviços onde o valor da propriedade CanPauseAndContinue é "True". Outro operador de pipeline transmite os resultados para o cmdlet Suspend-Service. O parâmetro Confirm solicita uma confirmação antes de suspender cada serviço.