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.