Restart-Service

Modulo:

Microsoft.PowerShell.Management Module

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

Questo cmdlet è disponibile solo nella piattaforma Windows.

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 usa il cmdlet Get-Service per ottenere oggetti che rappresentano i servizi il cui nome del servizio inizia con net. L'operatore pipeline (|) invia l'oggetto services al cmdlet Where-Object, che seleziona solo i servizi con stato arrestato. Un altro operatore 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

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

Questo cmdlet è disponibile solo nelle piattaforme Windows.

• 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 nel sistema, digitare Get-Service". I nomi dei servizi appaiono nella colonna Nome e i nomi visualizzati appaiono nella colonna DisplayName.

Collegamenti correlati

• Get-Service
• Nuovo Servizio
• Riprendi servizio
• Set-Service
• Start-Service
• Interrompi Servizio
• Suspend-Service
• Rimuovi-Servizio