Set-Service

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

O cmdlet Set-Service altera as propriedades de um serviço, como o Status, Descrição, DisplayName e 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 através do pipeline para Set-Service.

Neste exemplo, o nome de exibição de um serviço é alterado. Para ver 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 para exibição, LanMan Workstation.

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

Get-Service utiliza o parâmetro Nome para especificar o serviço BITS e envia o objeto através do pipeline. Select-Object usa o parâmetro Property para mostrar o estado do serviço BITS.

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

O cmdlet Get-CimInstance é usado porque retorna um objeto Win32_Service que inclui o Description 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.

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

Neste exemplo, um serviço é iniciado.

Set-Service -Name WinRM -Status Running -PassThru

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

Set-Service usa o parâmetro Name para especificar o serviço, WinRM. O parâmetro Status usa o valor Running para iniciar o serviço. O parâmetro PassThru fornece um objeto ServiceController que exibe os resultados.

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

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

Get-Service usa o parâmetro Name para especificar o serviço Schedule e envia o objeto pelo pipeline. Set-Service usa o parâmetro Status para definir o serviço como Paused.

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, Schedule. O objeto é armazenado na variável, $S. Set-Service usa o parâmetro InputObject e especifica o objeto armazenado $S. O parâmetro Status define o serviço como Parado.

O cmdlet Set-Service só aceita um nome de serviço de cada vez. No entanto, você pode encaminhar vários serviços para Set-Service para alterar a configuração de vários serviços.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

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.

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

Você pode canalizar uma cadeia de caracteres que contém um nome de serviço para esse cmdlet.

Por padrão, esse cmdlet não retorna nenhuma saída.

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

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

Set-Service só pode controlar 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 encontrar 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 Name e os nomes para exibição estão na coluna DisplayName.