Compartilhar via

Stop-Service

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

Interrompe 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

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

O Stop-Service cmdlet envia uma mensagem de parada para o Controlador de Serviço do Windows para cada um dos serviços especificados. Você pode especificar os serviços por seus nomes de serviço ou nomes de exibição ou pode usar o parâmetro InputObject para passar um objeto de serviço que representa o serviço que você deseja interromper.

Exemplos

Exemplo 1: Parar um serviço no computador local

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

Esse comando para os Alertas e Logs de Desempenho (SysmonLog) do serviço no computador local.

Exemplo 2: Parar um serviço usando o nome de exibição

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

Esse comando para o serviço Telnet no computador local. O comando usa Get-Service para obter um objeto que representa o serviço Telnet. O operador de pipeline (|) redireciona o objeto para Stop-Service, o que interrompe 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 interrompe o serviço IISAdmin no computador local. Como parar esse serviço também interrompe 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 do IISAdmin. Ele usa Get-Service para obter um objeto que representa o serviço IISAdmin. O operador de pipeline (|) passa o resultado para o Format-List cmdlet . O comando usa o parâmetro Property de Format-List para listar apenas as propriedades Name e DependentServices do serviço.

O segundo comando interrompe o serviço IISAdmin. O parâmetro Force é necessário para interromper um serviço que tenha serviços dependentes. O comando usa o parâmetro Confirm para solicitar a confirmação do usuário antes que ele pare cada serviço.

Parâmetros

-Confirm

Solicita 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 de exibição dos serviços a serem interrompidos. Caracteres curinga 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 esse cmdlet omite. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento ou padrão de nome, como s*. Caracteres curinga 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 esse cmdlet interrompe. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento ou padrão de nome, como s*. Caracteres curinga 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 serem interrompidos. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém 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 serem interrompidos. Caracteres curinga 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 esse cmdlet usa a opção sem espera.

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

-PassThru

Retorna um objeto que representa o serviço. Por padrão, este cmdlet não gera saída.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. 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

Você pode redirecionar um objeto de serviço para esse cmdlet.

String

Você pode redirecionar uma cadeia de caracteres que contém o nome de um serviço para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

ServiceController

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto ServiceController que representa o serviço.

Observações

O PowerShell inclui os seguintes aliases para Stop-Service:

  • Windows:
    • spsv

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

Stop-Service pode controlar os serviços somente quando o usuário atual tiver permissão para fazer isso. Se um comando não funcionar corretamente, pode ser que você não tenha as permissões necessárias.

Para localizar os nomes de serviço e os nomes de exibição dos serviços em seu sistema, digite Get-Service. Os nomes de serviço aparecem na coluna Nome e os nomes de exibição aparecem na coluna DisplayName .