Suspend-Service

Módulo:

Microsoft.PowerShell.Management Module

Suspende (pausa) um ou mais serviços em execução.

Sintaxe

InputObject (Predefinição)

Suspend-Service
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Suspend-Service
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName

Suspend-Service
    -DisplayName <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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

O cmdlet Suspend-Service envia uma mensagem de suspensão para o Windows Service Controller para cada um dos serviços especificados. Enquanto suspenso, o serviço ainda está em execução, mas sua ação é interrompida até ser retomada, como usando o cmdlet Resume-Service. 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

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

Suspend-Service -Name lanman* -WhatIf

Este 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

Get-Service schedule | Suspend-Service

Este comando usa o cmdlet Get-Service para obter um objeto que representa o serviço Agendador de Tarefas (Agendador) no computador. O operador do gasoduto (|) passa o resultado para Suspend-Service, que suspende o serviço.

Exemplo 4: Suspender todos os serviços que podem ser suspensos

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 cmdlet Where-Object, que seleciona apenas os serviços que têm um valor de $true para a propriedade CanPauseAndContinue. Outro operador de gasoduto passa os resultados para Suspend-Service. O parâmetro Confirm solicita confirmação antes de suspender cada um dos serviços.

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 para exibição dos serviços a serem suspensos. 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 a serem omitidos dos serviços especificados. 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

-Include

Especifica os serviços a serem suspensos. 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 suspensos. 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 suspensos. Caracteres coringa 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.

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

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. 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

ServiceController

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

String

Você pode canalizar 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.

ServiceController

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

Notas

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

• Suspend-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.
• Suspend-Service pode suspender apenas os serviços que suportam a suspensão e retomada. Para determinar se um determinado serviço pode ser suspenso, use o cmdlet Get-Service juntamente 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, digite Get-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.

Ligações Relacionadas

• Get-Service
• Novo Serviço
• Reiniciar Serviço
• Retomar o Serviço
• Set-Service
• Start-Service
• Parar Serviço
• Remove-Service