Partilhar via

Resume-Service

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxe

InputObject (Predefinição) 

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

Default 

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

DisplayName 

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

Description

O cmdlet Resume-Service 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 comando Get-Service cmdlet 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 Resume-Service, 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 confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisplayName

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

DisplayName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Exclude

Especifica os serviços que este cmdlet omite. O valor desse parâmetro qualifica o Name parâmetro. Insira um elemento ou padrão de nome, como s*. Caracteres coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Include

Especifica os serviços a serem retomados. O valor desse parâmetro qualifica parâmetro Name. Insira um elemento ou padrão de nome, como s*. Caracteres coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-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 obtenha os objetos.

Propriedades dos parâmetros

Tipo:

ServiceController[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:NomeDoServiço

Conjuntos de parâmetros

Default
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

System.ServiceProcess.ServiceController, System.String

Você pode canalizar um objeto de serviço ou uma cadeia de caracteres que contenha um nome de serviço para esse cmdlet.

Saídas

None, System.ServiceProcess.ServiceController

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

Notas

  • 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 de exibição aparecem na coluna DisplayName.