Set-Service
Inicia, para e suspende um serviço e altera suas propriedades.
Sintaxe
Name (Predefinição)
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
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 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.
Exemplos
Exemplo 1: Alterar um nome para exibição
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.
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 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.
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 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.
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...
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.
Exemplo 5: Suspender um serviço
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.
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, 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.
Parâmetros
-ComputerName
Especifica um ou mais computadores. Para computadores remotos, digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado. Se o parâmetro ComputerName não for especificado, o comando será executado no computador local.
Este parâmetro não depende de remoting do PowerShell. Você pode usar o parâmetro ComputerName mesmo que o computador não esteja configurado para executar comandos remotos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | Local computer |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | China |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar Set-Service.
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 |
-Description
Especifica uma nova descrição para o serviço.
A descrição do serviço aparece em Gerenciamento do Computador, Serviços. O Description não é uma propriedade do objetoServiceController Get-Service. Para ver a descrição do serviço, use Get-CimInstance que retorna um objeto Win32_Service que representa o serviço.
Propriedades dos parâmetros
| Tipo: | String |
| 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 |
-DisplayName
Especifica um novo nome para exibição para o serviço.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | DN |
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 um objeto ServiceController que representa o serviço a ser alterado. Insira uma variável que contenha o objeto ou digite um comando ou expressão que obtenha o objeto, como um comando Get-Service. Você pode usar o pipeline para enviar um objeto de serviço para Set-Service.
Propriedades dos parâmetros
| Tipo: | ServiceController |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObject
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome do serviço a ser alterado. Caracteres curinga não são permitidos. Você pode usar o pipeline para enviar um nome de serviço para Set-Service.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | NomeDoServiço, SN |
Conjuntos de parâmetros
Name
| 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 ServiceController que representa os serviços que foram alterados. Por padrão, Set-Service não gera nenhuma saída.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| 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 |
-StartupType
Especifica o modo de início do serviço.
Os valores aceitáveis para este parâmetro são os seguintes:
- Automático. Inicia quando o sistema é iniciado.
- Desativado. O serviço não pode ser iniciado.
- Manual. Inicia somente quando iniciado por um usuário ou programa.
Propriedades dos parâmetros
| Tipo: | ServiceStartMode |
| Default value: | None |
| Valores aceites: | Automatic, Boot, Disabled, Manual, System |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | StartMode, SM, ST |
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 |
-Status
Especifica o status do serviço.
Os valores aceitáveis para este parâmetro são os seguintes:
- Está em pausa. Suspende o serviço.
- Executando. Inicia o serviço.
- Parou. Interrompe o serviço.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Valores aceites: | Paused, Running, Stopped |
| 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 Set-Service corresse. 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
System.ServiceProcess.ServiceController, System.String
Você pode usar o pipeline para enviar um objeto de serviço ou uma cadeia de caracteres que contenha 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 a saída de um objeto ServiceController .
Notas
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.