Compartilhar via

Suspend-Service

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

Suspende (pausa) um ou mais serviços em execução.

Sintaxe

Suspend-Service
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

O Suspend-Service cmdlet envia uma mensagem de suspensão ao Controlador de Serviço do Windows para cada um dos serviços especificados. Enquanto suspenso, o serviço ainda está em execução, mas sua ação é interrompida até ser retomada, como usando o Resume-Service cmdlet. 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 os serviços que você deseja suspender.

Exemplos

Exemplo 1: Suspender um serviço

PS C:\> Suspend-Service -DisplayName "Telnet"

Este comando suspende o serviço Telnet (Tlntsvr) no computador local.

Exemplo 2: Exibir o que aconteceria se você suspendesse os serviços

PS C:\> Suspend-Service -Name lanman* -WhatIf

Esse comando informa 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: Obter e suspender um serviço

PS C:\> Get-Service schedule | Suspend-Service

Esse comando usa o Get-Service cmdlet para obter um objeto que representa o serviço Agendador de Tarefas (Agendamento) no computador. O operador de pipeline (|) passa o resultado para Suspend-Service, que suspende o serviço.

Exemplo 4: Suspender todos os serviços que podem ser suspensos

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Este comando suspende todos os serviços no computador que podem ser suspensos. Ele usa Get-Service para obter objetos que representam os serviços no computador. O operador de pipeline passa os resultados para o Where-Object cmdlet, que seleciona apenas os serviços que têm um valor de $True para a propriedade CanPauseAndContinue . Outro operador de pipeline passa os resultados para Suspend-Service. O parâmetro Confirm solicita confirmação antes de suspender cada um dos serviços.

Parâmetros

-Confirm

Solicita sua 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 suspensos. 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 a serem omitidos dos serviços especificados. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento Name ou padrão, 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

-Include

Especifica os serviços a serem suspensos. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento Name ou padrão, 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 suspensos. Insira uma variável que contém os objetos ou digite um comando ou uma 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 suspensos. Caracteres curinga são permitidos.

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

Tipo:String[]
Aliases:ServiceName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera 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

ServiceController

Você pode canalizar um objeto de serviço para esse cmdlet.

String

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

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

ServiceController

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto ServiceController que representa o serviço.

Observações

  • Suspend-Service pode controlar os serviços somente quando o usuário atual tiver permissão para fazer isso. Se um comando não funcionar corretamente, pode ser que você não tenha as permissões necessárias.
  • Suspend-Service pode suspender apenas os serviços que suportam a suspensão e a retomada. Para determinar se um serviço específico pode ser suspenso, use o Get-Service cmdlet junto 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 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 e os nomes de exibição aparecem na coluna DisplayName .