Partilhar via

Stop-Service

  • Referência
Módulo:
Microsoft.PowerShell.Management

Para um ou mais serviços em execução.

Syntax

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>]

Description

Este cmdlet só está disponível na plataforma do Windows.

O Stop-Service cmdlet envia uma mensagem de paragem para o Controlador de Serviço do Windows para cada um dos serviços especificados. Pode especificar os serviços pelos respetivos nomes de serviço ou nomes a apresentar ou pode utilizar o parâmetro InputObject para transmitir um objeto de serviço que representa o serviço que pretende parar.

Exemplos

Exemplo 1: Parar um serviço no computador local

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

Este comando para o serviço Registos de Desempenho e Alertas (SysmonLog) no computador local.

Exemplo 2: Parar um serviço com o nome a apresentar

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

Este comando para o serviço Telnet no computador local. O comando utiliza Get-Service para obter um objeto que representa o serviço Telnet. O operador de pipeline (|) encaminha o objeto para Stop-Service, o que para o serviço.

Exemplo 3: Parar um serviço que tenha serviços dependentes

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

Este exemplo para o serviço IISAdmin no computador local. Uma vez que parar este serviço também para os serviços que dependem do serviço IISAdmin, é melhor preceder Stop-Service com um comando que lista os serviços que dependem do serviço IISAdmin.

O primeiro comando lista os serviços que dependem de IISAdmin. Get-Service Utiliza para obter um objeto que representa o serviço IISAdmin. O operador de pipeline (|) transmite o resultado para o Format-List cmdlet . O comando utiliza o parâmetro Propriedade de Format-List para listar apenas as propriedades Name e DependentServices do serviço.

O segundo comando para o serviço IISAdmin. O parâmetro Force é necessário para parar um serviço que tenha serviços dependentes. O comando utiliza o parâmetro Confirmar para pedir confirmação ao utilizador antes de parar cada serviço.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica os nomes a apresentar dos serviços a parar. Os carateres universais são permitidos.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Especifica os serviços que este cmdlet omite. O valor deste parâmetro qualifica o parâmetro Name . Introduza um elemento ou padrão de nome, como s*. Os carateres universais são permitidos.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

Força o cmdlet a parar um serviço, mesmo que esse serviço tenha serviços dependentes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Especifica os serviços que este cmdlet para. O valor deste parâmetro qualifica o parâmetro Name . Introduza um elemento ou padrão de nome, como s*. Os carateres universais são permitidos.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

Especifica objetos ServiceController que representam os serviços a parar. Introduza uma variável que contenha os objetos ou escreva um comando ou expressão que obtenha os objetos.

Type:ServiceController[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica os nomes de serviço dos serviços a parar. Os carateres universais são permitidos.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-NoWait

Indica que este cmdlet utiliza a opção sem espera.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Devolve um objeto que representa o serviço. Por predefinição, este cmdlet não gera quaisquer dados.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

ServiceController

Pode encaminhar um objeto de serviço para este cmdlet.

String

Pode encaminhar uma cadeia que contém o nome de um serviço para este cmdlet.

Saídas

None

Por predefinição, este cmdlet não devolve nenhuma saída.

ServiceController

Quando utiliza o parâmetro PassThru , este cmdlet devolve um objeto ServiceController que representa o serviço.

Notas

O PowerShell inclui os seguintes aliases para Stop-Service:

  • Windows:
    • spsv

Este cmdlet só está disponível em plataformas do Windows.

Stop-Service só pode controlar os serviços quando o utilizador atual tem permissão para o fazer. Se um comando não funcionar corretamente, poderá não ter as permissões necessárias.

Para localizar os nomes dos serviços e os nomes a apresentar dos serviços no seu sistema, escreva Get-Service. Os nomes dos serviços aparecem na coluna Nome e os nomes a apresentar aparecem na coluna DisplayName .