New-Service
Cria um novo serviço do Windows.
Sintaxe
Default (Predefinição)
New-Service
[-Name] <String>
[-BinaryPathName] <String>
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Credential <PSCredential>]
[-DependsOn <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet New-Service cria uma nova entrada para um serviço do Windows no Registro e no banco de dados de serviço. Um novo serviço requer um arquivo executável que é executado durante o serviço.
Os parâmetros desse cmdlet permitem definir o nome para exibição, a descrição, o tipo de inicialização e as dependências do serviço.
Exemplos
Exemplo 1: Criar um serviço
PS C:\> New-Service -Name "TestService" -BinaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs"
Este comando cria um serviço chamado TestService.
Exemplo 2: Criar um serviço que inclua descrição, tipo de inicialização e nome para exibição
PS C:\> New-Service -Name "TestService" -BinaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs" -DependsOn NetLogon -DisplayName "Test Service" -StartupType Manual -Description "This is a test service."
Este comando cria um serviço chamado TestService. Ele usa os parâmetros de New-Service para especificar uma descrição, tipo de inicialização e nome de exibição para o novo serviço.
Exemplo 3: Ver o novo serviço
PS C:\> Get-WmiObject win32_service -Filter "name='testservice'"
ExitCode : 0
Name : testservice
ProcessId : 0
StartMode : Auto
State : Stopped
Status : OK
Este comando usa Get-WmiObject para obter o objeto Win32_Service para o novo serviço. Este objeto inclui o modo de início e a descrição do serviço.
Exemplo 4: Excluir um serviço
PS C:\> sc.exe delete TestService
- or -
PS C:\> (Get-WmiObject win32_service -Filter "name='TestService'").delete()
Este exemplo mostra duas maneiras de excluir o serviço TestService. O primeiro comando usa a opção delete de Sc.exe. O segundo comando usa o método Delete dos objetos Win32_Service que Get-WmiObject retorna.
Parâmetros
-BinaryPathName
Especifica o caminho do arquivo executável para o serviço. Este parâmetro é obrigatório.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-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 |
-Credential
Especifica a conta usada pelo serviço como a Conta de Logon do Serviço .
Digite um nome de usuário, como User01 ou Domain01\User01, ou insira um objeto PSCredential
Propriedades dos parâmetros
| Tipo: | PSCredential |
| 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 |
-DependsOn
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.
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 |
-Description
Especifica uma descrição do 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 nome para exibição para 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 |
-Name
Especifica o nome do serviço. Este parâmetro é obrigatório.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | NomeDoServiço |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-StartupType
Define o tipo de inicialização do serviço. Os valores aceitáveis para este parâmetro são:
- Manual. O serviço é iniciado apenas manualmente, por um usuário, usando o Service Control Manager ou por um aplicativo.
- 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.
- Desativado. O serviço está desativado e não pode ser iniciado por um usuário ou aplicativo.
O valor padrão é Automático.
Propriedades dos parâmetros
| Tipo: | ServiceStartMode |
| Default value: | None |
| Valores aceites: | Automatic, Manual, Disabled |
| 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
None
Não é possível canalizar a entrada para este cmdlet.
Saídas
ServiceController
Este cmdlet retorna um objeto que representa o novo serviço.
Notas
- Para executar esse cmdlet no Windows Vista e em versões posteriores do sistema operacional Windows, inicie o Windows PowerShell usando a opção Executar como administrador.
- Para excluir um serviço, use Sc.exeou use o cmdlet Get-WmiObject para obter o objeto Win32_Service que representa o serviço e, em seguida, use o método Delete para excluir o serviço. O objeto que Get-Service retorna não tem um método delete.