Start-Service

Inicia um ou mais serviços parados.

Sintaxe

Start-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Start-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Start-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Start-Service envia uma mensagem de início 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 a exibição de um erro. É possível especificar os serviços por seus nomes ou por seus nomes de exibição, ou usar o parâmetro InputObject para fornecer um objeto de serviço que represente os serviços que você deseja iniciar.

Parâmetros

-DisplayName <string[]>

Especifica os nomes de exibição dos serviços a serem iniciados. Os caracteres curinga são permitidos.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Exclude <string[]>

Omite os serviços especificados. O valor desse parâmetro qualifica o parâmetro Name. Digite um elemento ou padrão do nome, como "s*". Os caracteres curinga são permitidos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Include <string[]>

Inicia somente os serviços especificados. O valor desse parâmetro qualifica o parâmetro Name. Digite um elemento ou padrão do nome, como "s*". Os caracteres curinga são permitidos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-InputObject <ServiceController[]>

Especifica os objetos ServiceController que representam os serviços que devem ser iniciados. Insira uma variável que contenha os objetos ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Name <string[]>

Especifica os nomes para o serviço a ser iniciado.

O nome do parâmetro é opcional. Você pode usar "-Name" ou seu alias, "-ServiceName", ou omitir o nome do parâmetro.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

-PassThru

Retorna um objeto que representa o serviço. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	System.ServiceProcess.ServiceController, System.String Você pode enviar objetos que representam os serviços ou cadeias de caracteres que contêm os nomes de serviços para Start-Service.
Saídas	Nenhum ou System.ServiceProcess.ServiceController Quando você usa o parâmetro PassThru, o Start-Service gera um objeto System.ServiceProcess.ServiceController que representa o serviço. Caso contrário, esse cmdlet não gera nenhuma saída.

Observações

Você também pode fazer referência a Start-Service usando seu alias interno, "sasv". Para obter mais informações, consulte about_Aliases.

Start-Service poderá controlar os serviços somente quando o usuário atual tiver permissão para isso. Se um comando não funcionar corretamente, talvez você não tenha as permissões necessárias.

Para encontrar os nomes de serviços e os nomes de exibição dos serviços no seu sistema, digite "Get-Service". Os nomes de serviços são exibidos na coluna Name e o nome de exibição na coluna DisplayName.

Você pode iniciar apenas os serviços que tenham um tipo de inicialização "Manual" ou "Automática". Você não pode iniciar os serviços com um tipo de inicialização "Desabilitado". Se um comando Start-Service falhar com a mensagem “Não é possível iniciar o serviço <nome-do-serviço> no computador”, use o comando Get-WmiObject para localizar o tipo de inicialização do serviço e, se necessário, use um comando Set-Service para alterar o tipo de inicialização do serviço.

Alguns serviços, como o Logs e Alertas de Desempenho (SysmonLog) param automaticamente se não tiverem uma tarefa a cumprir. Quando o Windows PowerShell inicia um serviço que para automaticamente quase que de modo imediato, ele exibe a seguinte mensagem: “A inicialização do serviço <nome-de-exibição> falhou.”

Exemplo 1

C:\PS>start-service -name eventlog

Descrição
-----------
Esse comando inicia o serviço Log de Eventos no computador local. Ele utiliza o parâmetro Name para identificar o serviço por seu nome.

Exemplo 2

C:\PS>start-service -displayname *remote* -whatif

Descrição
-----------
Esse comando diz o que acontece se você iniciar os serviços com um nome de exibição que inclui "remote". Ele usa o parâmetro DisplayName para especificar os serviços pelo nome de exibição em vez do nome de serviço. E ele usa o parâmetro WhatIf para dizer o que acontece se o comando for executado, em vez de simplesmente executá-lo.

Exemplo 3

C:\PS>$s = get-service wmi

C:\PS>start-service -InputObject $s -passthru | format-list >> services.txt

Descrição
-----------
Esses comandos iniciam o serviço WMI no computador e adicionam um Registro da ação ao arquivo services.txt. O primeiro comando usa o cmdlet Get-Service para obter um objeto que represente o serviço WMI e o armazena na variável $s. 

O segundo comando usa o cmdlet Start-Service para iniciar o serviço WMI. Ele identifica o serviço usando o parâmetro InputObject para transmitir a variável $s que contém o objeto do serviço WMI para Start-Service. Em seguida, usa o parâmetro PassThru para criar um objeto que representa a inicialização do serviço. Sem esse parâmetro, Start-Service não cria nenhuma saída.

O operador de pipeline (|) transmite o objeto criado por Start-Service para o cmdlet Format-List, que o formata como uma lista de suas propriedades. O operador de redirecionamento de anexo (>>) redireciona a saída para o arquivo services.txt, onde é adicionada ao final do arquivo existente.

Exemplo 4

C:\PS># start-service

Descrição
-----------
Essa série de comandos mostra como iniciar um serviço quando o tipo de inicialização do serviço é "Disabled". O primeiro comando, que usa o cmdlet Start-Service para iniciar o serviço Telnet (tlntsvr), falha.

C:\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

O segundo comando usa o cmdlet Get-WmiObject para obter o serviço Tlntsvr. Ele recupera um objeto com a propriedade do tipo de inicialização no campo StartMode. A exibição resultante revela que o tipo de inicialização do serviço Tlntsvr é "Disabled".

C:\PS> get-wmiobject win32_service | where-object {$_.Name -eq "tlntsvr"}

ExitCode  : 0
Name      : TlntSvr
ProcessId : 0
StartMode : Disabled
State     : Stopped
Status    : OK

O próximo comando usa o cmdlet Set-Service para alterar o tipo de inicialização do serviço Tlntsvr para "Manual".

C:\PS> set-service tlntsvr -startuptype manual

Agora, podemos reenviar o comando Start-Service. Dessa vez, o comando terá sucesso.

C:\PS> start-service tlntsvr

Para verificar se o comando funcionou, use Get-Service:

Consulte também

Conceitos

Get-Service
Suspend-Service
Stop-Service
Restart-Service
Resume-Service
Set-Service
New-Service