Set-Service
Inicia, para e suspende um serviço e altera suas propriedades.
Syntax
Set-Service
[-ComputerName <String[]>]
[-Name] <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 Set-Service
cmdlet altera as propriedades de um serviço, como Status, Description, 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 para o 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 exibir o nome para 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 Automático.
Get-Service
usa o parâmetro Name para especificar o serviço BITS e envia o objeto pelo pipeline. Select-Object
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 Get-CimInstance
cmdlet é usado porque retorna um objeto Win32_Service que inclui a 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 e Format-List
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 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...
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 gera uma saída para 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.
Exemplo 7: Definir o tipo de inicialização para vários serviços
O Set-Service
cmdlet só aceita um nome de serviço de cada vez. No entanto, você pode canalizar vários serviços para Set-Service
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
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.
Esse parâmetro não depende da comunicação remota do PowerShell. Você pode usar o parâmetro ComputerName mesmo que o computador não esteja configurado para executar comandos remotos.
Type: | String[] |
Aliases: | cn |
Position: | Named |
Default value: | Local computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Solicita confirmação antes de executar Set-Service
o .
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica uma nova descrição para o serviço.
A descrição do serviço aparece em Gerenciamento do Computador, Serviços. A Description não é uma propriedade do Get-Service
objeto ServiceController . Para ver a descrição do serviço, use Get-CimInstance
que retorna um objeto Win32_Service que representa o serviço.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica um novo nome para exibição para o serviço.
Nota
Normalmente, Set-Service
opera apenas em serviços do Windows e não drivers. No entanto, se você especificar o nome de um driver, Set-Service
pode direcionar o driver.
Type: | String |
Aliases: | DN |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Get-Service
comando. Você pode usar o pipeline para enviar um objeto de serviço para .Set-Service
Type: | ServiceController |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Nota
Normalmente, Set-Service
opera apenas em serviços do Windows e não drivers. No entanto, se você especificar o nome de um driver, Set-Service
pode direcionar o driver.
Type: | String |
Aliases: | ServiceName, SN |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartupType
Define o tipo de inicialização do serviço. Os valores aceitáveis para este parâmetro são:
- Automático - O serviço é iniciado ou foi iniciado pelo sistema operacional, na inicialização do sistema. Se um serviço iniciado automaticamente depender de um serviço iniciado manualmente, o serviço iniciado manualmente também será iniciado automaticamente na inicialização do sistema.
- Desabilitado - O serviço está desativado e não pode ser iniciado por um usuário ou aplicativo.
- Manual - O serviço é iniciado apenas manualmente, por um usuário, usando o Service Control Manager, ou por um aplicativo.
- Boot - Indica que o serviço é um driver de dispositivo iniciado pelo carregador do sistema. Esse valor é válido apenas para drivers de dispositivo.
- Sistema - Indica que o serviço é um driver de dispositivo iniciado pela função 'IOInitSystem()'. Esse valor é válido apenas para drivers de dispositivo.
O valor padrão é Automático.
Type: | ServiceStartMode |
Aliases: | StartMode, SM, ST |
Accepted values: | Boot, System, Automatic, Manual, Disabled |
Position: | Named |
Default value: | Automatic |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
Especifica o status do serviço.
Os valores aceitáveis para este parâmetro são os seguintes:
- Em pausa. Suspende o serviço.
- A Executar. Inicia o serviço.
- Parado. Interrompe o serviço.
Type: | String |
Accepted values: | Paused, Running, Stopped |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se Set-Service
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 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.
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 .
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 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 para exibição estão na coluna DisplayName .
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários