New-Service

Sintaxis

Default (valor predeterminado)

New-Service
    [-Name] <String>
    [-BinaryPathName] <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-SecurityDescriptorSddl <String>]
    [-StartupType <ServiceStartupType>]
    [-Credential <PSCredential>]
    [-DependsOn <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Creación de un servicio

New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'

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

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

Ejemplo 4: Establecer securityDescriptor de un servicio al 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

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.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

Especifica la cuenta que utiliza el servicio como Cuenta de inicio de sesión del servicio.

Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential, como uno generado por el cmdlet Get-Credential. 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.

Propiedades de parámetro

Conjuntos de parámetros

-DependsOn

Especifica los nombres de otros servicios en los que depende el nuevo servicio. Para especificar varios nombres de servicio, use una coma para separar los nombres.

Propiedades de parámetro

Conjuntos de parámetros

-Description

Especifica una descripción del servicio.

Propiedades de parámetro

Conjuntos de parámetros

-DisplayName

Especifica un nombre para mostrar para el servicio.

Propiedades de parámetro

Conjuntos de parámetros

-Name

Especifica el nombre del servicio. Este parámetro es obligatorio.

Propiedades de parámetro

Conjuntos de parámetros

-SecurityDescriptorSddl

Especifica el SecurityDescriptor para el servicio en formato Sddl.

Propiedades de parámetro

Conjuntos de parámetros

-StartupType

Establece el tipo de inicio del servicio. Los valores aceptables para este parámetro son:

• Automático - El servicio es iniciado o fue iniciado por el sistema operativo, al inicio del sistema. Si un servicio iniciado automáticamente depende de un servicio iniciado manualmente, el servicio iniciado manualmente también se inicia automáticamente en el inicio del 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 Automatic.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

None

Salidas

ServiceController

Notas

Vínculos relacionados

• Get-Service
• Reiniciar servicio
• Resume-Service
• Set-Service
• Start-Service
• Stop-Service
• Suspend-Service
• Remove-Service