Compartilhar via

Resume-Service

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

Retoma um ou mais serviços suspensos (pausados).

Sintaxe

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

Description

O cmdlet Resume-Service envia uma mensagem de retomada ao Controlador de Serviço do Windows para cada um dos serviços especificados. Se um serviço for suspenso, ele será retomado. Se estiver em execução no momento, a mensagem será ignorada. 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 retomar.

Exemplos

Exemplo 1: retomar um serviço no computador local

PS C:\> Resume-Service "sens"

Esse comando retoma o serviço de Notificação de Eventos do Sistema no computador local. O nome do serviço é representado no comando por sens. O comando usa o parâmetro Name para especificar o nome do serviço, mas o comando omite o nome do parâmetro porque o nome do parâmetro é opcional.

Exemplo 2: retomar todos os serviços suspensos

PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service

Esse comando retoma todos os serviços suspensos no computador. O comando cmdlet Get-Service obtém todos os serviços no computador. O operador de pipeline (|) passa os resultados para o cmdlet Where-Object, que seleciona os serviços que têm uma propriedade Status de Paused. O próximo operador de pipeline envia os resultados para de Serviço de Retomada, que retoma os serviços em pausa.

Na prática, você usaria o parâmetro WhatIf para determinar o efeito do comando antes de executá-lo.

Parâmetros

-Confirm

Solicita a 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 retomados. 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 que esse cmdlet omite. O valor desse parâmetro qualifica o parâmetro Name. Insira um elemento ou padrão de nome, 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 retomados. O valor desse parâmetro qualifica o parâmetro Name. Insira um elemento ou padrão de nome, 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 servicecontroller objetos que representam os serviços a serem retomados. Insira uma variável que contenha os objetos ou digite um comando ou 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 retomados.

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

-PassThru

Retorna um objeto que representa o serviço. Por padrão, esse cmdlet não gera nenhuma 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

System.ServiceProcess.ServiceController, System.String

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

Saídas

None, System.ServiceProcess.ServiceController

Esse cmdlet gera um objeto System.ServiceProcess.ServiceController que representa o serviço retomado, se você especificar o parâmetro PassThru. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

  • O status dos serviços que foram suspensos é pausado. Quando os serviços são retomados, seu status é Em execução.
  • de Serviço de Retomada só poderá controlar os serviços quando o usuário atual tiver permissão para fazer isso. Se um comando não funcionar corretamente, talvez você não tenha as permissões necessárias.
  • 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.