Restart-Service
Para e, em seguida, 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
Este 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 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 você 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 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"
Este 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 de rede.
Exemplo 3: Iniciar todos os serviços de rede interrompidos
PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service
Este comando inicia todos os serviços de rede interrompidos no computador.
Este 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 services para o Where-Object
cmdlet, que seleciona apenas os serviços que têm um status de interrompido. 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 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 este 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 pedir 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 este 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 os 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 obtenha 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, esse cmdlet não gera nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. 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
Você pode canalizar um objeto de serviço para esse cmdlet.
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.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto ServiceController que representa o serviço reiniciado.
Notas
Este 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, talvez você não tenha as permissões necessárias.- Para encontrar os nomes de serviço e 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 para exibição aparecem na coluna DisplayName .
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários