Restart-Service

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Arresta e quindi avvia uno o più servizi.

Sintassi

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>]

Descrizione

Il Restart-Service cmdlet invia un messaggio di arresto e quindi un messaggio di avvio al controller del servizio Windows per un servizio specificato. Se un servizio era già arrestato, viene avviato senza informare l'utente di un errore. È possibile specificare i servizi in base ai nomi dei servizi o ai nomi visualizzati oppure usare il parametro InputObject per passare un oggetto che rappresenta ogni servizio da riavviare.

Esempio

Esempio 1: Riavviare un servizio nel computer locale

PS C:\> Restart-Service -Name winmgmt

Questo comando riavvia il servizio Strumentazione gestione Windows (WinMgmt) nel computer locale.

Esempio 2: Escludere un servizio

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

Questo comando riavvia i servizi con un nome visualizzato che inizia con Net, ad eccezione del servizio Accesso rete.

Esempio 3: Avviare tutti i servizi di rete arrestati

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

Questo comando riavvia tutti i servizi arrestati nel computer.

Questo comando usa il Get-Service cmdlet per ottenere oggetti che rappresentano i servizi il cui nome del servizio inizia con net. L'operatore pipeline (|) invia l'oggetto services al Where-Object cmdlet , che seleziona solo i servizi con stato arrestato. Un altro operatore pipeline invia i servizi selezionati a Restart-Service.

In pratica, si userebbe il parametro WhatIf per determinare l'effetto del comando prima di eseguirlo.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Specifica i nomi visualizzati dei servizi da riavviare. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Exclude

Specifica i servizi che questo cmdlet omette. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un criterio nome, ad esempio s*. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Include

Specifica i servizi riavviati da questo cmdlet. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un criterio nome, ad esempio s*. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-InputObject

Specifica gli oggetti ServiceController che rappresentano i servizi da riavviare. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.

Tipo:ServiceController[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi dei servizi da riavviare.

Tipo:String[]
Alias:ServiceName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-PassThru

Restituisce un oggetto che rappresenta il servizio. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

ServiceController

È possibile inviare tramite pipe un oggetto servizio a questo cmdlet.

String

È possibile inviare tramite pipe una stringa contenente un nome di servizio a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

ServiceController

Quando si usa il parametro PassThru , questo cmdlet restituisce un oggetto ServiceController che rappresenta il servizio riavviato.

Note

  • Restart-Service può controllare i servizi solo quando l'utente corrente dispone dell'autorizzazione per eseguire questa operazione. Se un comando non funziona correttamente, l'utente potrebbe non avere le autorizzazioni richieste.
  • Per trovare i nomi dei servizi e i nomi visualizzati dei servizi nel sistema, digitare Get-Service". I nomi dei servizi vengono visualizzati nella colonna Nome e i nomi visualizzati vengono visualizzati nella colonna DisplayName .