Restart-Service

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

Interrompe e inicia um ou mais serviços.

Syntax

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

Esse cmdlet só está disponível na plataforma Windows.

O Restart-Service cmdlet envia uma mensagem de parada e, em seguida, uma mensagem de início para o Windows Service Controller para um serviço especificado. Se um serviço já foi interrompido, ele é 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

Este comando reinicia o serviço de instrumentação de gerenciamento do Windows (WinMgmt) 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 Logon de Rede.

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

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 Get-Service cmdlet 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 Where-Object cmdlet, que seleciona apenas os serviços que têm um status de parado. Outro operador de pipeline envia os serviços selecionados para o 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 sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

ServiceController

Você pode canalizar um objeto de serviço para esse cmdlet.

String

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

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

ServiceController

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto ServiceController que representa o serviço reiniciado.

Observações

Esse cmdlet só está disponível em plataformas Windows.

  • Restart-Service pode controlar serviços somente quando o usuário atual tem permissão para fazer isso. Se um comando não funcionar corretamente, pode ser que você não tenha as permissões necessárias.
  • Para localizar os nomes de serviço e exibir os nomes 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 .