New-Service
Crea un servicio de Windows.
Syntax
New-Service
[-Name] <String>
[-BinaryPathName] <String>
[-DisplayName <String>]
[-Description <String>]
[-SecurityDescriptorSddl <String>]
[-StartupType <ServiceStartupType>]
[-Credential <PSCredential>]
[-DependsOn <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet solo está disponible en la plataforma Windows.
El New-Service
cmdlet crea una nueva entrada para un servicio de Windows en el Registro y en la base de datos de servicio. Un nuevo servicio requiere un archivo ejecutable que se ejecuta durante el servicio.
Los parámetros de este cmdlet permiten definir el nombre para mostrar, la descripción, el tipo de inicio y las dependencias del servicio.
Ejemplos
Ejemplo 1: Creación de un servicio
New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
Este comando crea un servicio denominado TestService.
Ejemplo 2: Creación de un servicio que incluya descripción, tipo de inicio y nombre para mostrar
$params = @{
Name = "TestService"
BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
DependsOn = "NetLogon"
DisplayName = "Test Service"
StartupType = "Manual"
Description = "This is a test service."
}
New-Service @params
Este comando crea un servicio denominado TestService. Usa los parámetros de New-Service
para especificar una descripción, un tipo de inicio y un nombre para mostrar para el nuevo servicio.
Ejemplo 3: Visualización del nuevo servicio
Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"
ExitCode : 0
Name : testservice
ProcessId : 0
StartMode : Auto
State : Stopped
Status : OK
Este comando usa Get-CimInstance
para obtener el objeto Win32_Service para el nuevo servicio. Este objeto incluye el modo de inicio y la descripción del servicio.
Ejemplo 4: Establecer securityDescriptor de un servicio al crear.
En este ejemplo se agrega securityDescriptor del servicio que se va a crear.
$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
$params = @{
BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
DependsOn = "NetLogon"
DisplayName = "Test Service"
StartupType = "Manual"
Description = "This is a test service."
SecurityDescriptorSddl = $SDDL
}
New-Service @params
SecurityDescriptor se almacena en la $SDDLToSet
variable . El parámetro SecurityDescriptorSddl usa $SDDL
para establecer securityDescriptor del nuevo servicio.
Parámetros
-BinaryPathName
Especifica la ruta de acceso del archivo ejecutable para el servicio. Este parámetro es obligatorio.
Ruta de acceso completa al archivo binario del servicio. Si la ruta de acceso contiene un espacio, se debe citar para que se interprete correctamente. Por ejemplo, d:\my share\myservice.exe
debe especificarse como '"d:\my share\myservice.exe"'
.
La ruta de acceso también puede incluir argumentos para un servicio de inicio automático. Por ejemplo, '"d:\my share\myservice.exe" arg1 arg2'
. Estos argumentos se pasan al punto de entrada de servicio.
Para obtener más información, consulte el parámetro lpBinaryPathName de CreateServiceW API.
Type: | String |
Aliases: | Path |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica la cuenta usada por el servicio como cuenta de inicio de sesión de servicio.
Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto PSCredential , como uno generado por el Get-Credential
cmdlet. Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.
Las credenciales se almacenan en un objeto PSCredential y la contraseña se almacena como SecureString.
Nota:
Para obtener más información sobre la protección de datos SecureString , consulte ¿Cómo es secure is SecureString?.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DependsOn
Especifica los nombres de los otros servicios de los que el nuevo servicio depende. Si se van a especificar varios nombres de servicio, use comas para separarlos.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica una descripción del servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica un nombre para mostrar del servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre del servicio. Este parámetro es obligatorio.
Type: | String |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Especifica securityDescriptor para el servicio en formato Sddl.
Type: | String |
Aliases: | sd |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartupType
Establece el tipo de inicio del servicio. Los valores permitidos para este parámetro son los siguientes:
- Automático : el sistema operativo inicia o inicia el servicio en el inicio del sistema. Si un servicio iniciado automáticamente depende de un servicio iniciado de forma manual, el servicio iniciado de forma manual también se iniciará automáticamente al iniciarse el sistema.
- AutomaticDelayedStart : se inicia poco después del arranque del sistema.
- Deshabilitado : el servicio está deshabilitado y no puede iniciarlo un usuario o una aplicación.
- InvalidValue : este valor no se admite. El uso de este valor produce un error.
- Manual : el servicio solo se inicia manualmente, por un usuario, mediante service Control Manager o por una aplicación.
El valor predeterminado es Automático.
Type: | ServiceStartupType |
Accepted values: | Automatic, Manual, Disabled, AutomaticDelayedStart, InvalidValue |
Position: | Named |
Default value: | Automatic |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
No se pueden canalizar objetos a este cmdlet.
Salidas
Este cmdlet devuelve un objeto que representa el nuevo servicio.
Notas
Este cmdlet solo está disponible en plataformas Windows.
Para ejecutar este cmdlet, inicie PowerShell mediante la opción Ejecutar como administrador .
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de