Restart-Service

Para e então inicia um ou mais serviços.

Sintaxe

Restart-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Restart-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Restart-Service envia uma mensagem de parada e, em seguida, uma mensagem de início para o Windows Service Controller para um serviço especificado. Caso o serviço já esteja parado, ele será iniciado sem qualquer notificação de erro. É 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 que represente cada serviço 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

-Force

Cancela as restrições que impedem a execução do comando, simplesmente para que as alterações não comprometam a segurança. Por exemplo, Force para e reinicia um serviço que não tenha serviços dependentes.

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 a serem reiniciados. 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.

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, System.String Você pode enviar um objeto de serviço ou uma cadeia de caracteres que contém um nome de serviço para Restart-Service.
Saídas	Nenhum ou System.ServiceProcess.ServiceController Quando você usa o parâmetro PassThru, o Restart-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

Restart-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 os nomes de exibição na coluna DisplayName.

Exemplo 1

C:\PS>restart-service wmi

Descrição
-----------
Esse comando reinicia o serviço Windows Management Instrumentation (WMI) no computador local.

Exemplo 2

C:\PS>restart-service -displayname net* -exclude "net logon"

Descrição
-----------
Esse comando reinicia os serviços com nomes de exibição que iniciam com "Net", exceto o serviço "Net Logon" (Logon de rede).

Exemplo 3

C:\PS>get-service net* | where-object {$_.Status -eq "Stopped"} | restart-service

Descrição
-----------
Esse comando inicia todos os serviços de rede parados no computador.

Ele usa o cmdlet Get-Service para obter objetos que representam os serviços cujos nomes comecem com "net". (O nome do parâmetro opcional Name é omitido.) O operador de pipeline (|) envia o objeto de serviços para o cmdlet Where-Object, que seleciona somente os serviços com o status “parado”. Outro operador de pipeline envia os serviços selecionados para Restart-Service. Na prática, você deveria usar o parâmetro WhatIf para ver o efeito do comando antes de usá-lo.

Consulte também

Conceitos

Start-Service
Stop-Service
Suspend-Service
Resume-Service
New-Service
Get-Service
Set-Service