Suspend-Service
Suspende (pausa) um ou mais serviços em execução.
Syntax
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Suspend-Service
cmdlet envia uma mensagem de suspensão ao Controlador de Serviço do Windows para cada um dos serviços especificados. Enquanto estiver suspenso, o serviço ainda estará em execução, mas sua ação será interrompida até ser retomada, como usando o Resume-Service
cmdlet . 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 os serviços que você deseja suspender.
Exemplos
Exemplo 1: Suspender um serviço
PS C:\> Suspend-Service -DisplayName "Telnet"
Este comando suspende o serviço Telnet (Tlntsvr) no computador local.
Exemplo 2: exibir o que aconteceria se você suspendesse os serviços
PS C:\> Suspend-Service -Name lanman* -WhatIf
Esse comando informa o que aconteceria se você suspendesse os serviços que têm um nome de serviço que começa com lanman. Para suspender os serviços, execute novamente o comando sem o parâmetro WhatIf .
Exemplo 3: Obter e suspender um serviço
PS C:\> Get-Service schedule | Suspend-Service
Esse comando usa o Get-Service
cmdlet para obter um objeto que representa o serviço Agendador de Tarefas (Agendamento) no computador. O operador de pipeline (|
) passa o resultado para Suspend-Service
, que suspende o serviço.
Exemplo 4: Suspender todos os serviços que podem ser suspensos
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm
Este comando suspende todos os serviços no computador que podem ser suspensos. Ele usa Get-Service
para obter objetos que representam os serviços no computador. O operador de pipeline passa os resultados para o Where-Object
cmdlet , que seleciona apenas os serviços que têm um valor de $True
para a propriedade CanPauseAndContinue . Outro operador de pipeline passa os resultados para Suspend-Service
. O parâmetro Confirm solicita a confirmação antes de suspender cada um dos serviços.
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 suspensos. 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 a serem omitidos dos serviços especificados. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento Name ou padrão, como "*s". Caracteres curinga são permitidos.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
Especifica os serviços a serem suspensos. O valor desse parâmetro qualifica o parâmetro Name . Insira um elemento Name ou padrão, 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 suspensos. 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 suspensos. Caracteres curinga são permitidos.
O nome do parâmetro é opcional. Você pode usar Name ou seu alias, ServiceName ou pode omitir o nome do parâmetro.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Retorna um objeto que representa o item com que você está trabalhando. 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 redirecionar um objeto de serviço para esse cmdlet.
Você pode redirecionar uma cadeia de caracteres que contém um nome de 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
Esse cmdlet só está disponível em plataformas Windows.
Suspend-Service
só pode controlar serviços 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.Suspend-Service
pode suspender apenas os serviços que dão suporte a serem suspensos e retomados. Para determinar se um serviço específico pode ser suspenso, use oGet-Service
cmdlet junto com a propriedade CanPauseAndContinue . Por exemplo,Get-Service wmi | Format-List Name, CanPauseAndContinue
. Para localizar todos os serviços no computador que podem ser suspensos, digiteGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
.- 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 .