Stop-Service
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 ao 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"
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 para exibição
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Esse comando para o serviço Telnet no computador local. O comando é usado 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 tem 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 somente 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 confirmação do usuário antes de interromper 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 interromper 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
Você pode canalizar um objeto de serviço para esse cmdlet.
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.
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 serviços somente quando o usuário atual tem 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 .
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de