Crea un nuevo servicio de Windows.
Sintaxis
New-Service [-Name] <string> [-BinaryPathName] <string> [-Credential <PSCredential>] [-DependsOn <string[]>] [-Description <string>] [-DisplayName <string>] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet New-Service crea una nueva entrada para un servicio de Windows en el Registro y en la base de datos de servicios. Un nuevo servicio requiere un archivo ejecutable que se ejecuta durante el servicio.
Los parámetros de este cmdlet permiten establecer el nombre para mostrar, una descripción, el tipo de inicio y las dependencias del servicio.
Parámetros
-BinaryPathName <string>
Especifica la ruta del archivo ejecutable del servicio. Este parámetro es obligatorio.
|
¿Requerido? |
true |
|
¿Posición? |
2 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01". O bien, escriba un objeto PSCredential, como el devuelto por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-DependsOn <string[]>
Especifica los nombres de otros servicios de los que depende el nuevo servicio. Para escribir varios nombres de servicio, utilice una coma para separarlos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
ninguno |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Description <string>
Especifica una descripción del servicio.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-DisplayName <string>
Especifica un nombre para mostrar para el servicio.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Name <string>
Especifica el nombre del servicio. Este parámetro es obligatorio.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-StartupType <ServiceStartMode>
Establece el tipo de inicio del servicio. El valor predeterminado es "Automatic".
Los valores válidos son:
-- Manual: el servicio se inicia sólo manualmente, por un usuario (utilizando el Administrador de control de servicios) o por una aplicación.
-- Automatic: el servicio será iniciado (o fue iniciado) por el sistema operativo, en el inicio del sistema. Si un servicio iniciado automáticamente depende de un servicio iniciado manualmente, este último también se inicia automáticamente en el inicio del sistema.
-- Disabled: el servicio está deshabilitado y no puede ser iniciado por un usuario o por una aplicación.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
Automatic |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No se pueden canalizar entradas a este cmdlet. |
|
Salidas |
System.ServiceProcess.ServiceController New-Service devuelve un objeto que representa el nuevo servicio. |
Notas
Para ejecutar este cmdlet en Windows Vista y versiones posteriores de Windows, inicie Windows PowerShell con la opción "Ejecutar como administrador".
Ejemplo 1
C:\PS>new-service -name TestService -binaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs" Descripción ----------- Este comando crea un nuevo servicio denominado "TestService".
Ejemplo 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." Descripción ----------- Este comando crea un nuevo servicio denominado "TestService". Utiliza los parámetros del cmdlet New-Service para especificar una descripción, el tipo de inicio y el nombre para mostrar del nuevo servicio. Para especificar el parámetro BinaryPathName, el comando usa el alias de parámetro Path. También puede utilizar "-bpn".
Ejemplo 3
C:\PS>get-wmiobject win32_service -filter "name='testservice'" ExitCode : 0 Name : testservice ProcessId : 0 StartMode : Auto State : Stopped Status : OK Descripción ----------- Este comando utiliza el cmdlet Get-WmiObject para obtener el objeto Win32_Service para el nuevo servicio. Este objeto incluye el modo de inicio y la descripción del servicio.
Vea también