Compartir a través de


Set-Service

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

Sintaxis

Name (valor predeterminado)

Set-Service
    [-Name] <String>
    [-ComputerName <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-StartupType <ServiceStartMode>]
    [-Status <String>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Set-Service
    [-ComputerName <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-StartupType <ServiceStartMode>]
    [-Status <String>]
    [-InputObject <ServiceController>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Set-Service cambia las propiedades de un servicio, como Status, Description, DisplayNamey 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 a la canalización para Set-Service.

Ejemplos

Ejemplo 1: Cambiar un nombre para mostrar

En este ejemplo, se cambia el nombre visible de un servicio. Para ver el nombre de pantalla 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 Automatic.

Get-Service usa el parámetro Name para especificar el servicio BITS y envía el objeto por 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.

Se utiliza el cmdlet Get-CimInstance 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 por 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 de 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 de horario y envía el objeto por 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 Stopped.

Parámetros

-ComputerName

Especifica uno o varios equipos. En equipos remotos, escriba el nombre NetBIOS, una dirección IP o un nombre de dominio completo. Si no se especifica el parámetro ComputerName, el comando se ejecuta en el equipo local.

Este parámetro no utiliza la comunicación remota de PowerShell. Puede usar el parámetro ComputerName incluso si el equipo no está configurado para ejecutar comandos remotos.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:Local computer
Admite caracteres comodín:False
DontShow:False
Alias:China

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Confirm

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Especifica una nueva descripción para el servicio.

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DisplayName

Especifica un nombre para mostrar nuevo para el servicio.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:DN

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 comando Get-Service. Puede usar la canalización para enviar un objeto de servicio a Set-Service.

Propiedades de parámetro

Tipo:ServiceController
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

InputObject
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:NombreDelServicio, SN

Conjuntos de parámetros

Name
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PassThru

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-StartupType

Especifica el modo de inicio del servicio.

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

  • Automática. Se inicia cuando se inicia el sistema.
  • Disabled. No se puede iniciar el servicio.
  • Manual. Solo se inicia cuando un usuario o programa inicia.

Propiedades de parámetro

Tipo:ServiceStartMode
Valor predeterminado:None
Valores aceptados:Automatic, Boot, Disabled, Manual, System
Admite caracteres comodín:False
DontShow:False
Alias:StartMode, SM, ST

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Status

Especifica el estado del servicio.

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

  • En pausa Suspende el servicio.
  • Ejecución. inicia el servicio.
  • Detenido. Detiene el servicio.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Valores aceptados:Paused, Running, Stopped
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que ocurriría si se ejecuta Set-Service. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

System.ServiceProcess.ServiceController, System.String

Puede usar la canalización para enviar un objeto de servicio o una cadena que contenga un nombre de servicio a Set-Service.

Salidas

ServiceController

De forma predeterminada, Set-Service no devuelve ningún objeto. Utilice el parámetro PassThru para generar un objeto ServiceController .

Notas

Set-Service requiere permisos elevados. Utilice 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 del servicio o el nombre para mostrar de un servicio, use Get-Service. Los nombres de servicio se encuentran en la columna Name y los nombres para mostrar aparecen en la columna DisplayName.