Set-Service

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Inicia, detiene y suspende un servicio y cambia sus propiedades.

Syntax

Set-Service
   [-Name] <String>
   [-DisplayName <String>]
   [-Credential <PSCredential>]
   [-Description <String>]
   [-StartupType <ServiceStartupType>]
   [-Status <String>]
   [-SecurityDescriptorSddl <String>]
   [-Force]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-Service
   [-InputObject] <ServiceController>
   [-DisplayName <String>]
   [-Credential <PSCredential>]
   [-Description <String>]
   [-StartupType <ServiceStartupType>]
   [-SecurityDescriptorSddl <String>]
   [-Status <String>]
   [-Force]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Set-Service cmdlet cambia las propiedades de un servicio como Status, Description, DisplayName y StartupType. Set-Service puede iniciar, detener, suspender o pausar un servicio. Para identificar un servicio, escriba su nombre de servicio o envíe un objeto de servicio. O bien, envíe un nombre de servicio o un objeto de servicio de la canalización a Set-Service.

Ejemplos

Ejemplo 1: Cambiar un nombre para mostrar

En este ejemplo, se cambia el nombre para mostrar de un servicio. Para ver el nombre para mostrar original, use Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service usa el parámetro Name para especificar el nombre del servicio, LanmanWorkstation. El parámetro DisplayName especifica el nuevo nombre para mostrar, LanMan Workstation.

Ejemplo 2: Cambiar el tipo de inicio de los servicios

En este ejemplo se muestra cómo cambiar el tipo de inicio de un servicio.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service usa el parámetro Name para especificar el nombre del servicio, BITS. El parámetro StartupType establece el servicio en Automático.

Get-Service usa el parámetro Name para especificar el servicio BITS y envía el objeto a la canalización. Select-Object usa el parámetro Property para mostrar el estado del servicio BITS .

Ejemplo 3: Cambiar la descripción de un servicio

En este ejemplo se cambia la descripción del servicio BITS y se muestra el resultado.

El Get-CimInstance cmdlet se usa porque devuelve un objeto Win32_Service que incluye la descripción del servicio.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance envía el objeto de la canalización a Format-List y muestra el nombre y la descripción del servicio. Con fines de comparación, el comando se ejecuta antes y después de actualizar la descripción.

Set-Service usa el parámetro Name para especificar el servicio BITS . El parámetro Description especifica el texto actualizado para la descripción de los servicios.

Ejemplo 4: Iniciar un servicio

En este ejemplo, se inicia un servicio.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-Service usa el parámetro Name para especificar el servicio, WinRM. El parámetro Status usa el valor Running para iniciar el servicio. El parámetro PassThru genera un objeto ServiceController que muestra los resultados.

Ejemplo 5: Suspender un servicio

En este ejemplo se usa la canalización para pausar el servicio.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Service usa el parámetro Name para especificar el servicio Schedule y envía el objeto a la canalización. Set-Service usa el parámetro Status para establecer el servicio en Pausado.

Ejemplo 6: Detener un servicio

En este ejemplo se usa una variable para detener un servicio.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service usa el parámetro Name para especificar el servicio, Schedule. El objeto se almacena en la variable , $S. Set-Service usa el parámetro InputObject y especifica el objeto almacenado $S. El parámetro Status establece el servicio en Detenido.

Ejemplo 7: Detener un servicio en un sistema remoto

En este ejemplo se detiene un servicio en un equipo remoto. Para obtener más información, vea Invoke-Command.

$Cred = Get-Credential
$S = Get-Service -Name Schedule
Invoke-Command -ComputerName server01.contoso.com -Credential $Cred -ScriptBlock {
  Set-Service -InputObject $S -Status Stopped
}

Get-Credential solicita un nombre de usuario y una contraseña, y almacena las credenciales en la $Cred variable . Get-Service usa el parámetro Name para especificar el servicio Schedule . El objeto se almacena en la variable , $S.

Invoke-Command usa el parámetro ComputerName para especificar un equipo remoto. El parámetro Credential usa la $Cred variable para iniciar sesión en el equipo. ScriptBlock llama a Set-Service. El parámetro InputObject especifica el objeto de servicio almacenado $S. El parámetro Status establece el servicio en Detenido.

Ejemplo 8: Cambio de credencial de un servicio

En este ejemplo se cambian las credenciales que se usan para administrar un servicio.

$credential = Get-Credential
Set-Service -Name Schedule -Credential $credential

Get-Credential solicita un nombre de usuario y una contraseña, y almacena las credenciales en la $credential variable . Set-Service usa el parámetro Name para especificar el servicio Schedule . El parámetro Credential usa la $credential variable y actualiza el servicio Schedule .

Ejemplo 9: Cambiar securityDescriptor de un servicio

En este ejemplo se cambia securityDescriptor de un servicio.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
Set-Service -Name "BITS" -SecurityDescriptorSddl $SDDL

SecurityDescriptor se almacena en la $SDDL variable . Set-Service usa el parámetro Name para especificar el servicio BITS . El parámetro SecurityDescriptorSddl usa $SDDL para cambiar securityDescriptor para el servicio BITS.

Ejemplo 10: Establecimiento del tipo de inicio para varios servicios

El Set-Service cmdlet solo acepta un nombre de servicio a la vez. Sin embargo, puede canalizar varios servicios para Set-Service cambiar la configuración de varios servicios.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

Parámetros

-Confirm

Le pide confirmación antes de ejecutar Set-Service.

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?.

Este parámetro se introdujo en PowerShell 6.0.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica una nueva descripción para el servicio.

La descripción del servicio aparece en Administración de equipos, Servicios. Descripción no es una propiedad del Get-Serviceobjeto ServiceController. Para ver la descripción del servicio, use Get-CimInstance que devuelve un objeto Win32_Service que representa el servicio.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica un nombre para mostrar nuevo para el servicio.

Nota:

Normalmente, Set-Service solo funciona en servicios de Windows y no en controladores. Sin embargo, si especifica el nombre de un controlador, Set-Service puede dirigirse al controlador.

Type:String
Aliases:DN
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Especifica el modo Stop del servicio. Este parámetro solo funciona cuando -Status Stopped se usa. Si está habilitado, Set-Service detiene los servicios dependientes antes de que se detenga el servicio de destino. De forma predeterminada, se generan excepciones cuando otros servicios en ejecución dependen del servicio de destino.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica un objeto ServiceController que representa el servicio que se va a cambiar. Escriba una variable que contenga el objeto o escriba un comando o expresión que obtenga el objeto, como un Get-Service comando. Puede usar la canalización para enviar un objeto de servicio a Set-Service.

Type:ServiceController
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre del servicio que se va a cambiar. No se permiten caracteres comodín. Puede usar la canalización para enviar un nombre de servicio a Set-Service.

Nota:

Normalmente, Set-Service solo funciona en servicios de Windows y no en controladores. Sin embargo, si especifica el nombre de un controlador, Set-Service puede dirigirse al controlador.

Type:String
Aliases:ServiceName, SN
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devuelve un objeto ServiceController que representa los servicios que se cambiaron. De forma predeterminada, Set-Service no genera ninguna salida.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

Especifica securityDescriptor para el servicio en formato Sddl. La cuenta que llama Set-Service a con este parámetro debe tener los permisos WRITE_DAC y WRITE_OWNER. Para obtener más información, consulte Derechos de acceso y seguridad del servicio.

Type:String
Aliases:sd
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartupType

Especifica el modo de inicio del servicio.

Los valores aceptables 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 : no tiene ningún efecto. El cmdlet no devuelve un error, pero no se cambia startupType del servicio.
  • Manual : el servicio solo se inicia manualmente, por un usuario, mediante service Control Manager o por una aplicación.
Type:Microsoft.PowerShell.Commands.ServiceStartupType
Aliases:StartMode, SM, ST, StartType
Accepted values:Automatic, AutomaticDelayedStart, Disabled, InvalidValue, Manual
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

Especifica el estado del servicio.

Los valores aceptables para este parámetro son los siguientes:

  • En pausa. suspende el servicio.
  • En ejecución. inicia el servicio.
  • Detenido. detiene el servicio.
Type:String
Accepted values:Paused, Running, Stopped
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si Set-Service se ejecutase. 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

ServiceController

Puede canalizar un objeto de servicio a este cmdlet.

String

Puede canalizar una cadena que contenga un nombre de servicio a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

ServiceController

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto ServiceController .

Notas

Este cmdlet solo está disponible en plataformas Windows.

Set-Service requiere permisos elevados. Use la opción Ejecutar como administrador .

Set-Service solo puede controlar los servicios cuando el usuario actual tiene permisos para administrar los servicios. Si un comando no funciona correctamente, es posible que no tenga los permisos necesarios.

Para buscar el nombre de servicio o el nombre para mostrar de un servicio, use Get-Service. Los nombres de servicio se encuentran en la columna Nombre y los nombres para mostrar se encuentran en la columna DisplayName .