Condividi tramite

Stop-Service

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

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 cmdlet Stop-Service 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 Log prestazioni e avvisi (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 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. Usa Get-Service per ottenere un oggetto che rappresenta il servizio IISAdmin. L'operatore pipeline (|) passa il risultato al cmdlet Format-List. 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. Sono consentiti caratteri jolly.

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 nome. Immettere un elemento o un criterio nome, ad esempio s*. Sono consentiti caratteri jolly.

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 nome. Immettere un elemento o un criterio nome, ad esempio s*. Sono consentiti caratteri jolly.

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

-InputObject

Specifica oggetti ServiceController che rappresentano i servizi da arrestare. Immettere una variabile contenente 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. Sono consentiti caratteri jolly.

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, questo 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 cosa accadrebbe se il cmdlet viene eseguito. 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 utilizza il parametro PassThru, questo cmdlet restituisce un oggetto ServiceController che rappresenta il servizio.

Note

PowerShell include gli alias seguenti per Stop-Service:

  • Finestre:
    • 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, è 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 vengono visualizzati nella colonna nome e i nomi visualizzati vengono visualizzati nella colonna DisplayName.