Resume-Service

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

Sintaxe

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

Descrição

O cmdlet Resume-Service envia uma mensagem de reinício para o Windows Service Controller para cada um dos serviços especificados. Se eles tiverem sido suspensos, serão reiniciados. Se estiverem em execução, a mensagem será ignorada. É possível especificar os serviços por seus nomes ou por seus nomes de exibição, ou usar o parâmetro InputObject para passar um objeto de serviço que represente os serviços que você deseja reiniciar.

Parâmetros

-DisplayName <string[]>

Especifica os nomes de exibição dos serviços a serem reiniciados. 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[]>

Reinicia 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 continuados. 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 reiniciados.

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 string que contém um nome de serviço para Resume-Service.

Saídas None ou System.ServiceProcess.ServiceController

Quando você usa o parâmetro PassThru, o Resume-Service gera um objeto System.ServiceProcess.ServiceController que representa o serviço reiniciado. Caso contrário, esse cmdlet não gera nenhuma saída.

Observações

O status dos serviços que foram suspensos é "Pausado". Quando os serviços são reiniciados, o status é "Executando".

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

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>resume-service sens
Descrição
-----------
Esse comando reinicia o serviço Notificação de Eventos de Sistema (o nome do serviço é representado no comando por "sens") no computador local. O comando usa o parâmetro Name para especificar o nome do serviço, mas omite o nome do parâmetro, pois ele é opcional.

Exemplo 2

C:\PS>get-service | where-object {$_.Status -eq "Paused"} | resume-service
Descrição
-----------
Esse comando reinicia todos os serviços suspensos (pausados) no computador. O primeiro comando obtém todos os serviços do computador. O operador de pipeline (|) transmite os resultados para o cmdlet Where-Object, que seleciona os serviços cuja propriedade Status seja "Pausado". O próximo operador de pipeline envia o resultado a Resume-Service que reinicia os serviços pausados.
Na prática, você deveria usar o parâmetro WhatIf para determinar o efeito do comando antes de executá-lo sem WhatIf.

See Also