Arresta uno o più servizi in esecuzione.
Sintassi
Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Stop-Service invia un messaggio di arresto al controller dei servizi di Windows per ognuno dei servizi specificati. È possibile specificare i servizi in base al relativo nome o nome visualizzato oppure utilizzare il parametro InputObject per passare un oggetto servizio che rappresenta i servizi che si desidera arrestare.
Parametri
-DisplayName <string[]>
Specifica i nomi visualizzati dei servizi da arrestare. È 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
Consente al cmdlet di arrestare un servizio anche se tale servizio dispone di servizi dipendenti.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Include <string[]>
Arresta 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 arrestare. 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 arrestare. È consentito l'utilizzo di caratteri jolly.
Il nome del parametro è facoltativo. È possibile utilizzare "Name" o il relativo alias, "ServiceName", oppure omettere il nome del parametro.
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 o System.String. È possibile reindirizzare un oggetto servizio o una stringa che contiene il nome di un servizio a Stop-Service. |
Output |
Nessuno o System.ServiceProcess.ServiceController Quando si utilizza il parametro PassThru, Stop-Service genera un oggetto System.ServiceProcess.ServiceController che rappresenta il servizio. Negli altri casi, il cmdlet non genera alcun output. |
Note
È inoltre possibile fare riferimento a Stop-Service tramite il relativo alias predefinito "spsv". Per ulteriori informazioni, vedere about_Aliases.
Stop-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>stop-service sysmonlog Descrizione ----------- Tramite questo comando viene arrestato il servizio Avvisi e registri di prestazioni (SysmonLog) nel computer locale.
Esempio 2
C:\PS>get-service -displayname telnet | stop-service Descrizione ----------- Tramite questo comando viene arrestato il servizio Telnet nel computer locale. Viene utilizzato il cmdlet Get-Service per ottenere un oggetto che rappresenta il servizio Telnet. L'oggetto viene indirizzato dall'operatore pipeline (|) al cmdlet Stop-Service, il quale arresta il servizio.
Esempio 3
C:\PS>get-service iisadmin | format-list -property name, dependentservices C:PS>stop-service iisadmin -force -confirm Descrizione ----------- Tramite il comando Stop-Service viene arrestato il servizio IISAdmin nel computer locale. Poiché l'arresto di questo servizio comporta l'arresto dei servizi che dipendono dal servizio IISAdmin, è preferibile anteporre al comando Stop-Service un comando che elenchi i servizi che dipendono dal servizio IISAdmin. Tramite il primo comando vengono elencati i servizi che dipendono da IISAdmin. Viene utilizzato il cmdlet Get-Service per ottenere un oggetto che rappresenta il servizio IISAdmin. Il risultato viene passato dall'operatore pipeline (|) al cmdlet Format-List. Tramite il comando viene utilizzato il parametro Property di Format-List per elencare unicamente le proprietà Name e DependentServices del servizio. Tramite il secondo comando viene arrestato il servizio IISAdmin. Il parametro Force è necessario per arrestare un servizio da cui dipendono altri servizi. Viene utilizzato il parametro Confirm di questo comando per richiedere all'utente la conferma prima di arrestare ogni servizio.
Vedere anche