Start-Service
Inicia um ou mais serviços interrompidos.
Sintaxe
InputObject (Predefinição)
Start-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Start-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DisplayName
Start-Service
-DisplayName <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Start-Service envia uma mensagem inicial para o Windows Service Controller para cada um dos serviços especificados. Se um serviço já estiver em execução, a mensagem será ignorada sem erro. Você pode especificar os serviços por seus nomes de serviço ou nomes de exibição, ou você pode usar o parâmetro InputObject para fornecer um objeto de serviço que representa os serviços que você deseja iniciar.
Exemplos
Exemplo 1: Iniciar um serviço usando seu nome
Este exemplo inicia o serviço EventLog no computador local. O parâmetro Name identifica o serviço pelo seu nome de serviço.
Start-Service -Name "eventlog"
Exemplo 2: Exibir informações sem iniciar um serviço
Este exemplo mostra o que ocorreria se você iniciasse os serviços que têm um nome para exibição que inclui "remoto".
Start-Service -DisplayName *remote* -WhatIf
O parâmetro DisplayName identifica os serviços pelo nome para exibição em vez do nome do serviço. O parâmetro WhatIf faz com que o cmdlet exiba o que aconteceria quando você executa o comando, mas não faz alterações.
Exemplo 3: Iniciar um serviço e registrar a ação em um arquivo de texto
Este exemplo inicia o serviço WMI (Instrumentação de Gerenciamento do Windows) no computador e adiciona um registro da ação ao arquivo services.txt.
$s = Get-Service wmi
Start-Service -InputObject $s -PassThru | Format-List >> services.txt
Primeiro, usamos Get-Service para obter um objeto que representa o serviço WMI e armazená-lo na variável $s. Em seguida, iniciamos o serviço. Sem o PassThru parâmetro, Start-Service não cria nenhuma saída. O operador de pipeline (|) passa a saída do objeto por Start-Service para o cmdlet Format-List para formatar o objeto como uma lista de suas propriedades. O operador de redirecionamento append (>>) redireciona a saída para o arquivo services.txt. A saída é adicionada ao final do arquivo existente.
Exemplo 4: Iniciar um serviço desativado
Este exemplo mostra como iniciar um serviço quando o tipo de início do serviço é Desabilitado.
PS> Start-Service tlntsvr
Start-Service : Service 'Telnet (TlntSvr)' cannot be started due to the following error: Cannot
start service TlntSvr on computer '.'.
At line:1 char:14
+ Start-Service <<<< tlntsvr
PS> Get-CimInstance Win32_Service | Where-Object Name -EQ "tlntsvr"
ExitCode : 0
Name : TlntSvr
ProcessId : 0
StartMode : Disabled
State : Stopped
Status : OK
PS> Set-Service tlntsvr -StartupType manual
PS> Start-Service tlntsvr
A primeira tentativa de iniciar o serviço Telnet (tlntsvr) falha. O comando Get-CimInstance mostra que a propriedade StartMode do serviço Tlntsvr é Disabled. O cmdlet Set-Service altera o tipo de início para Manual. Agora, podemos reenviar o comando Start-Service. Desta vez, o comando é bem-sucedido. Para verificar se o comando foi bem-sucedido, execute Get-Service.
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 de exibição dos serviços a serem iniciados. 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 que este cmdlet omite. 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 que esse cmdlet inicia. 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 objetos ServiceController que representam os serviços a serem iniciados. Insira uma variável que contenha os objetos ou digite um comando ou expressão que obtenha os objetos.
Propriedades dos parâmetros
| Tipo: | |
| 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 dos serviços a serem iniciados.
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: | False |
| 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 serviço. 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 o nome do 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
O PowerShell inclui os seguintes aliases para Start-Service:
- Windows:
sasv
Este cmdlet só está disponível em plataformas Windows.
- Por padrão, apenas os membros do grupo Administradores podem iniciar, parar, pausar, retomar ou reiniciar um serviço. Se você for membro do grupo Administradores, precisará executar
Start-Servicea partir de uma sessão elevada do PowerShell. Use a opção Executar como administrador para iniciar o PowerShell. - 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. - Você pode iniciar apenas os serviços que têm um tipo de início de Manual, Automático ou Automático (Início atrasado). Não é possível iniciar os serviços que têm um tipo de início de Desativado. Se um comando
Start-Servicefalhar com a mensagemCannot start service \<service-name\> on computer, useGet-CimInstancepara localizar o tipo de início do serviço e, se necessário, use o cmdletSet-Servicepara alterar o tipo de início do serviço. - Alguns serviços, como Registos e Alertas de Desempenho (SysmonLog), param automaticamente se não tiverem trabalho para realizar. Quando o PowerShell inicia um serviço que para quase imediatamente, ele exibe a seguinte mensagem:
Service \<display-name\> start failed.