Set-Service

Sintaxe

Set-Service
   [-Name] <String>
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-Service
   [-ComputerName <String[]>]
   [-DisplayName <String>]
   [-Description <String>]
   [-StartupType <ServiceStartMode>]
   [-Status <String>]
   [-InputObject <ServiceController>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-Service altera as propriedades de um serviço, como Status, Description, DisplayNamee StartupType. Set-Service pode iniciar, parar, suspender ou pausar um serviço. Para identificar um serviço, insira seu nome de serviço ou envie um objeto de serviço. Ou envie um nome de serviço ou objeto de serviço pelo pipeline para Set-Service.

Exemplos

Exemplo 1: alterar um nome de exibição

Neste exemplo, o nome de exibição de um serviço é alterado. Para exibir o nome de exibição original, use Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service usa o parâmetro Name para especificar o nome do serviço, LanmanWorkstation. O parâmetro DisplayName especifica o novo nome de exibição, da Estação de Trabalho LanMan.

Exemplo 2: alterar o tipo de inicialização de serviços

Este exemplo mostra como alterar o tipo de inicialização de um serviço.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service usa o parâmetro Name para especificar o nome do serviço, BITS. O parâmetro StartupType define o serviço como Automático.

usa o parâmetro Name para especificar o serviço BITS e envia o objeto pelo pipeline. usa o parâmetro Property para exibir o status do serviço BITS .

Exemplo 3: alterar a descrição de um serviço

Este exemplo altera a descrição do serviço BITS e exibe o resultado.

O cmdlet é usado porque retorna um objeto Win32_Service que inclui ode Descrição do serviço.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance envia o objeto pelo pipeline para Format-List e exibe o nome e a descrição do serviço. Para fins de comparação, o comando é executado antes e depois que a descrição é atualizada.

usa o parâmetro Name para especificar o serviço BITS . O parâmetro Description especifica o texto atualizado para a descrição dos serviços.

Exemplo 4: Iniciar um serviço

Neste exemplo, um serviço é iniciado.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

usa o parâmetro nome do para especificar o serviço, WinRM. O parâmetro Status usa o valor Executando para iniciar o serviço. O parâmetro PassThru gera um objeto ServiceController que exibe os resultados.

Exemplo 5: suspender um serviço

Este exemplo usa o pipeline para pausar no serviço.

Get-Service -Name Schedule | Set-Service -Status Paused

usa o parâmetro Name para especificar o serviço agendamento de e envia o objeto pelo pipeline. usa o parâmetro status para definir o serviço como pausado.

Exemplo 6: Parar um serviço

Este exemplo usa uma variável para interromper um serviço.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service usa o parâmetro Name para especificar o serviço, Agendar. O objeto é armazenado na variável, $S. usa o parâmetro InputObject e especifica o objeto armazenado . O parâmetro status do define o serviço como parado.

Parâmetros

-ComputerName

-Confirm

-Description

-DisplayName

-InputObject

-Name

-PassThru

-StartupType

-Status

-WhatIf

Entradas

System.ServiceProcess.ServiceController, System.String

Você pode usar o pipeline para enviar um objeto de serviço ou uma cadeia de caracteres que contém um nome de serviço para Set-Service.

Saídas

ServiceController

Por padrão, Set-Service não retorna nenhum objeto. Use o parâmetro PassThru para gerar um objeto ServiceController.

Observações

Set-Service requer permissões elevadas. Use a opção Executar como administrador.

Set-Service só podem controlar os serviços quando o usuário atual tem permissões para gerenciar serviços. Se um comando não funcionar corretamente, talvez você não tenha as permissões necessárias.

Para localizar o nome de serviço ou o nome de exibição de um serviço, use Get-Service. Os nomes de serviço estão na coluna Nome e os nomes de exibição estão na coluna DisplayName.

Links Relacionados

• Get-Service
• New-Service
• Restart-Service
• Resume-Service
• Start-Service
• Stop-Service
• Suspend-Service