Restart-Service

Arresta e avvia uno o più servizi.

Sintassi

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

Descrizione

Il cmdlet Restart-Service invia un messaggio di arresto e uno di avvio al controller dei servizi di Windows per un servizio specificato. Se un servizio era già stato arrestato, viene avviato senza la notifica di un errore. È possibile specificare i servizi in base al relativo nome o nome visualizzato oppure utilizzare il parametro InputObject per passare un oggetto che rappresenta ogni servizio che si desidera riavviare.

Parametri

-DisplayName <string[]>

Specifica i nomi visualizzati dei servizi da riavviare. È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	true
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Exclude <string[]>

Omette i servizi specificati. Il valore di questo parametro qualifica il parametro Name. Immettere un criterio o un elemento del nome, ad esempio "s*". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Force

Ignora le restrizioni che impediscono la corretta esecuzione del comando, purché le modifiche non abbiano effetti negativi sulla sicurezza. Force, ad esempio, arresterà e riavvierà un servizio da cui dipendono altri servizi.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Include <string[]>

Riavvia unicamente i servizi specificati. Il valore di questo parametro qualifica il parametro Name. Immettere un criterio o un elemento del nome, ad esempio "s*". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-InputObject <ServiceController[]>

Specifica gli oggetti ServiceController che rappresentano i servizi da riavviare. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	true (ByValue)
Accettare caratteri jolly?	false

-Name <string[]>

Specifica i nomi dei servizi da riavviare.

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	true (ByValue, ByPropertyName)
Accettare caratteri jolly?	false

-PassThru

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

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input	System.ServiceProcess.ServiceController, System.String È possibile reindirizzare un oggetto o una stringa che contiene un nome servizio a Restart-Service.
Output	Nessuno o System.ServiceProcess.ServiceController Quando si utilizza il parametro PassThru, Restart-Service genera un oggetto System.ServiceProcess.ServiceController che rappresenta il servizio riavviato. Negli altri casi, il cmdlet non genera alcun output.

Note

Restart-Service consente di controllare i servizi solo se l'utente corrente dispone delle autorizzazioni necessarie. Se un comando non viene eseguito correttamente, è possibile che l'utente non disponga delle autorizzazioni necessarie.

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 Name e i nomi visualizzati vengono elencati nella colonna DisplayName.

Esempio 1

C:\PS>restart-service wmi

Descrizione
-----------
Tramite questo comando viene riavviato il servizio Strumentazione gestione Windows (WMI) nel computer locale.

Esempio 2

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

Descrizione
-----------
Tramite questo comando vengono riavviati i servizi il cui nome visualizzato inizia con "Net", ad eccezione del servizio "Net Logon".

Esempio 3

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

Descrizione
-----------
Tramite questo comando vengono avviati tutti i servizi di rete arrestati nel computer.

Viene utilizzato il cmdlet Get-Service per ottenere gli oggetti che rappresentano i servizi i cui nomi iniziano con "net". Il nome del parametro facoltativo Name viene omesso. L'operatore pipeline (|) invia l'oggetto servizi al cmdlet Where-Object che seleziona solo i servizi con lo stato "stopped". Un altro operatore pipeline invia i servizi selezionati a Restart-Service. Il parametro WhatIf viene in pratica utilizzato per stabilire gli effetti prodotti dal comando prima di utilizzarlo.

Vedere anche

Concetti

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