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 cadeia de caracteres que contém um nome de serviço para Suspend-Service.
Saídas	Nenhum 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.

Consulte também

Conceitos

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