Restart-Service
Arresta e quindi avvia uno o più servizi.
Sintassi
InputObject (Impostazione predefinita)
Restart-Service
[-InputObject] <ServiceController[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Restart-Service
[-Name] <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Restart-Service
-DisplayName <String[]>
[-Force]
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Restart-Service invia un messaggio di arresto e quindi un messaggio di avvio al controller del servizio Windows per un servizio specificato. Se un servizio è già stato arrestato, viene avviato senza avvisare 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 avvia tutti i servizi di rete arrestati nel computer.
Questo comando utilizza il cmdlet Get-Service per ottenere gli oggetti che rappresentano i servizi il cui nome inizia con net. L'operatore della pipeline (|) invia l'oggetto services al cmdlet Where-Object, che seleziona solo i servizi con stato arrestato. Un altro operatore della pipeline invia i servizi selezionati a Restart-Service.
In pratica, è necessario usare il parametro WhatIf per determinare l'effetto del comando prima di eseguirlo.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisplayName
Specifica i nomi visualizzati dei servizi da riavviare. Sono consentiti caratteri jolly.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
DisplayName
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Exclude
Specifica i servizi che questo cmdlet omette. Il valore di questo parametro specifica il parametro Nome. Immettere un elemento o un criterio nome, ad esempio s*. Sono consentiti caratteri jolly.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Forza l'esecuzione del comando senza chiedere conferma dell'utente.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Include
Specifica i servizi riavviati da questo cmdlet. Il valore di questo parametro specifica il parametro Nome. Immettere un elemento o un criterio nome, ad esempio s*. Sono consentiti caratteri jolly.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Specifica oggetti ServiceController che rappresentano i servizi da riavviare. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
Proprietà dei parametri
| Tipo: | ServiceController[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
InputObject
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica i nomi dei servizi da riavviare.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
| Alias: | Nome del servizio |
Set di parametri
Default
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Restituisce un oggetto che rappresenta il servizio. Per impostazione predefinita, questo cmdlet non genera alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
System.ServiceProcess.ServiceController, System.String
È possibile reindirizzare un oggetto servizio o una stringa contenente un nome di servizio a questo cmdlet.
Output
None, System.ServiceProcess.ServiceController
Questo cmdlet genera un oggetto System.ServiceProcess.ServiceController che rappresenta il servizio riavviato, se si specifica il parametro PassThru . In caso contrario, questo cmdlet non genera alcun output.
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, è possibile che non si disponga delle autorizzazioni necessarie.
- Per trovare i nomi dei servizi e i nomi visualizzati dei servizi sul sistema, digitare Get-Service". I nomi dei servizi appaiono nella colonna Nome e i nomi visualizzati appaiono nella colonna DisplayName.