Partilhar via

Stop-Service

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

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

Sintaxe

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 Windows.

O cmdlet Stop-Service envia uma mensagem de parada para o Windows Service Controller 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 parar.

Exemplos

Exemplo 1: Parar um serviço no computador local

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

Este comando para o serviço Logs e alertas de desempenho (SysmonLog) no computador local.

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

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

Este 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 (|) canaliza 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 a interrupção desse serviço também interrompe os serviços que dependem do serviço IISAdmin, é melhor precedê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 cmdlet Format-List. O comando usa o parâmetro Property 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 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 de parar cada serviço.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica os nomes de exibição dos serviços a serem interrompidos. Caracteres curinga são permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Exclude

Especifica os serviços que este cmdlet omite. O valor desse parâmetro qualifica o Name parâmetro. Insira um elemento ou padrão de nome, como s*. Caracteres curinga são permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Force

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Include

Especifica os serviços que esse cmdlet interrompe. O valor desse parâmetro qualifica o Name parâmetro. Insira um elemento ou padrão de nome, como s*. Caracteres curinga são permitidos.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-InputObject

Especifica ServiceController objetos que representam os serviços a serem interrompidos. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.

Tipo:ServiceController[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica os nomes de serviço dos serviços a serem interrompidos. Caracteres curinga são permitidos.

Tipo:String[]
Aliases:ServiceName
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-NoWait

Indica que esse cmdlet usa a opção no wait.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

ServiceController

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

String

Você pode canalizar 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 ServiceController objeto que representa o serviço.

Notas

O PowerShell inclui os seguintes aliases para Stop-Service:

  • Janelas:
    • spsv

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

Stop-Service pode controlar serviços somente quando o usuário atual tem permissão para fazer isso. Se um comando não funcionar corretamente, talvez 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 para exibição aparecem na coluna DisplayName.