Condividi tramite


Stop-Service

Arresta uno o più servizi in esecuzione.

Sintassi

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il Stop-Service cmdlet invia un messaggio di arresto al controller del servizio Windows per ognuno dei servizi specificati. È possibile specificare i servizi in base ai nomi dei servizi o ai nomi visualizzati oppure utilizzare il parametro InputObject per passare un oggetto servizio che rappresenta il servizio che si desidera arrestare.

Esempio

Esempio 1: Arrestare un servizio nel computer locale

PS C:\> Stop-Service -Name "sysmonlog"

Questo comando arresta il servizio Avvisi e registri di prestazioni (SysmonLog) nel computer locale.

Esempio 2: Arrestare un servizio usando il nome visualizzato

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

Questo comando arresta il servizio Telnet nel computer locale. Il comando usa Get-Service per ottenere un oggetto che rappresenta il servizio Telnet. L'operatore pipeline (|) invia tramite pipe l'oggetto a Stop-Service, che arresta il servizio.

Esempio 3: Arrestare un servizio con servizi dipendenti

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

In questo esempio viene arrestato il servizio IISAdmin nel computer locale. Poiché l'arresto di questo servizio arresta anche i servizi che dipendono dal servizio IISAdmin, è consigliabile precedere Stop-Service con un comando che elenca i servizi che dipendono dal servizio IISAdmin.

Il primo comando elenca i servizi che dipendono da IISAdmin. Get-Service Usa per ottenere un oggetto che rappresenta il servizio IISAdmin. L'operatore pipeline (|) passa il risultato al Format-List cmdlet . Il comando usa il parametro Property di Format-List per elencare solo le proprietà Name e DependentServices del servizio.

Il secondo comando arresta il servizio IISAdmin. Il parametro Force è necessario per arrestare un servizio con servizi dipendenti. Il comando usa il parametro Confirm per richiedere conferma all'utente prima di arrestare ogni servizio.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Specifica i nomi visualizzati dei servizi da arrestare. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Exclude

Specifica i servizi che questo cmdlet omette. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un criterio nome, ad esempio s*. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Force

Forza il cmdlet a arrestare un servizio anche se il servizio dispone di servizi dipendenti.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Include

Specifica i servizi arrestati da questo cmdlet. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un criterio nome, ad esempio s*. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-InputObject

Specifica gli oggetti ServiceController che rappresentano i servizi da arrestare. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.

Tipo:ServiceController[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi dei servizi da arrestare. I caratteri jolly sono consentiti.

Tipo:String[]
Alias:ServiceName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-NoWait

Indica che questo cmdlet usa l'opzione no wait.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

ServiceController

È possibile inviare tramite pipe un oggetto servizio a questo cmdlet.

String

È possibile inviare tramite pipe una stringa contenente il nome di un 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.

Note

PowerShell include gli alias seguenti per Stop-Service:

  • Windows:
    • spsv

Questo cmdlet è disponibile solo nelle piattaforme Windows.

Stop-Service può controllare i servizi solo quando l'utente corrente dispone dell'autorizzazione per eseguire questa operazione. Se un comando non funziona correttamente, l'utente potrebbe non avere le autorizzazioni richieste.

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