Share via

Resume-Service

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

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

Syntax

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

Este cmdlet só está disponível na plataforma Windows.

O Resume-Service cmdlet envia uma mensagem de currículo para o 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 você 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"

Este 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 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

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

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

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica os nomes para exibição dos serviços a serem retomados. Caracteres curinga são permitidos.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Especifica os serviços que este 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

Especifica os objetos ServiceController que representam os serviços a serem retomados. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica os nomes de serviço dos serviços a serem retomados.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retorna um objeto que representa o serviço. Por padrão, esse cmdlet não gera nenhuma saída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 retomado.

Notas

Este cmdlet só está disponível em plataformas Windows.

  • O status dos serviços que foram suspensos é pausado. Quando os serviços são retomados, seu status é Em execução.
  • Resume-Service pode controlar serviços somente quando o usuário atual tem 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 para exibição aparecem na coluna DisplayName .