Compartilhar via

Restart-Service

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

Para e, em seguida, inicia um ou mais serviços.

Sintaxe

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

Description

O cmdlet Restart-Service envia uma mensagem de parada e, em seguida, uma mensagem de início para o Controlador de Serviço do Windows para um serviço especificado. Se um serviço já tiver sido interrompido, ele será iniciado sem notificá-lo de um erro. Você pode especificar os serviços por seus nomes de serviço ou nomes de exibição ou pode usar o parâmetro InputObject para passar um objeto que representa cada serviço que você deseja reiniciar.

Exemplos

Exemplo 1: reiniciar um serviço no computador local

PS C:\> Restart-Service -Name winmgmt

Esse comando reinicia o WinMgmt (Serviço de Instrumentação de Gerenciamento do Windows) no computador local.

Exemplo 2: excluir um serviço

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

Esse comando reinicia os serviços que têm um nome de exibição que começa com Net, exceto para o serviço de Logon net.

Exemplo 3: Iniciar todos os serviços de rede interrompidos

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

Esse comando inicia todos os serviços de rede interrompidos no computador.

Esse comando usa o cmdlet Get-Service para obter objetos que representam os serviços cujo nome de serviço começa com net. O operador de pipeline (|) envia o objeto de serviços para o cmdlet Where-Object, que seleciona apenas os serviços que têm um status de parado. Outro operador de pipeline envia os serviços selecionados para restart-service.

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

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayName

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Exclude

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Include

Especifica os serviços que esse cmdlet reinicia. 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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-InputObject

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

Tipo:ServiceController[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String[]
Aliases:ServiceName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.ServiceProcess.ServiceController, System.String

Você pode canalizar um objeto de serviço ou uma cadeia de caracteres que contém um nome de serviço para este cmdlet.

Saídas

None, System.ServiceProcess.ServiceController

Esse cmdlet gera um objeto System.ServiceProcess.ServiceController que representa o serviço reiniciado, se você especificar o parâmetro PassThru. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

  • restart-service só pode controlar os serviços quando o usuário atual tiver 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.