Partilhar via

Stop-Service

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxe

InputObject (Predefinição) 

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

Default 

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

DisplayName 

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

Description

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DisplayName

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

DisplayName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-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 coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 coringa são permitidos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

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

Propriedades dos parâmetros

Tipo:

ServiceController[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InputObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False
Aliases:NomeDoServiço

Conjuntos de parâmetros

Default
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NoWait

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PassThru

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

System.ServiceProcess.ServiceController, System.String

Você pode canalizar um objeto de serviço ou uma cadeia de caracteres que contenha o nome de um serviço para esse cmdlet.

Saídas

None, System.ServiceProcess.ServiceController

Este cmdlet gera um objeto System.ServiceProcess.ServiceController que representa o serviço, se você usar o parâmetro PassThru. Caso contrário, esse cmdlet não gerará nenhuma saída.

Notas

  • Você também pode se referir a Stop-Service por seu alias interno, spsv. Para obter mais informações, consulte about_Aliases.

    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.