Stop-Service
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
Concetti
Get-Service
Suspend-Service
Start-Service
Restart-Service
Resume-Service
Set-Service
New-Service