New-Service

Artigo
10/30/2009

Cria um novo serviço do Windows.

Sintaxe

New-Service [-Name] <string> [-BinaryPathName] <string> [-Credential <PSCredential>] [-DependsOn <string[]>] [-Descrição <string>] [-DisplayName <string>] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet New-Service cria uma nova entrada para um serviço do Windows no Registro e no banco de dados do serviço. Um novo serviço requer um arquivo executável que executa durante o serviço.

Os parâmetros desse cmdlet permitem definir o nome de exibição, a descrição, o tipo de inicialização e as dependências do serviço.

Parâmetros

-BinaryPathName <string>

Especifica o caminho até o arquivo executável do serviço. Esse parâmetro é obrigatório.

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

-Credential <PSCredential>

Especifica uma conta de usuário com permissão para executar essa ação. Digite um nome de usuário, como “User01” ou “Domain01\User01”. Ou insira um objeto PSCredential, como o retornado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.

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

-DependsOn <string[]>

Especifica os nomes de outros serviços dos quais o novo serviço depende. Para inserir vários nomes de serviço, use uma vírgula para separar os nomes.

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

-Descrição <string>

Especifica uma descrição do serviço.

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

-DisplayName <string>

Especifica o nome para exibição do serviço.

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

-Name <string>

Especifica o nome do serviço. Esse parâmetro é obrigatório.

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

-StartupType <ServiceStartMode>

Define o tipo de inicialização do serviço. O padrão é “Automatic ”.

Os valores válidos são:

-- Manual: o serviço é iniciado apenas manualmente, por um usuário (usando o Gerenciador de Controle de Serviços) ou por um aplicativo.

-- Automatic: o serviço será (ou foi) iniciado pelo sistema operacional, durante a 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 de maneira automática durante a inicialização do sistema.

-- Disabled: o serviço está desabilitado e não pode ser iniciado por um usuário ou aplicativo.

Necessário?	false
Posição?	named
Valor padrão	Automatic
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

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

System.ServiceProcess.ServiceController

O cmdlet New-Service retorna um objeto que representa o novo serviço.

Observações

Para executar este cmdlet no Windows Vista e em versões mais recentes do Windows, inicie o Windows PowerShell com a opção "Executar como administrador".

Exemplo 1

C:\PS>new-service -name TestService -binaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs"

Descrição
-----------
Esse comando cria um novo serviço chamado "TestService".

Exemplo 2

C:\PS>new-service -name TestService -path "C:\WINDOWS\System32\svchost.exe -k netsvcs" -dependson NetLogon -displayName "Test Service" -StartupType Manual -Description "This is a test service."

Descrição
-----------
Esse comando cria um novo serviço chamado "TestService". Ele usa os parâmetros do cmdlet New-Service para especificar a descrição, o tipo de inicialização e o nome de exibição do novo serviço.

Para especificar o parâmetro BinaryPathName, o comando usa o alias de parâmetro Path. Você também pode usar "-bpn".

Exemplo 3

C:\PS>get-wmiobject win32_service -filter "name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Descrição
-----------
Esse comando usa o cmdlet Get-WmiObject para obter o objeto Win32_Service para o novo serviço. Esse objeto inclui o modo de inicialização e a descrição do serviço.

Consulte também

Conceitos

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

Compartilhar via