Detiene uno o más servicios en ejecución.

Sintaxis

Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Stop-Service envía al controlador de servicios de Windows un mensaje para detener cada uno de los servicios especificados. Puede especificar los servicios por su nombre de servicio o por su nombre para mostrar, o puede usar el parámetro InputObject para pasar un objeto de servicio que represente a los servicios que desee detener.

Parámetros

-DisplayName <string[]>

Especifica los nombres para mostrar de los servicios que se van a detener. Se permite el uso de caracteres comodín.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Exclude <string[]>

Omite los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

Permite al cmdlet detener un servicio incluso si ese servicio tiene servicios dependientes.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Include <string[]>

Detiene únicamente los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-InputObject <ServiceController[]>

Especifica objetos ServiceController que representan los servicios que se van a detener. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Name <string[]>

Especifica los nombres de los servicios que se van a detener. Se permite el uso de caracteres comodín.

El nombre del parámetro es opcional. Puede usar "Name" o su alias, "ServiceName", o bien, puede omitir el nombre del parámetro.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

false

-PassThru

Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿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 se 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

System.ServiceProcess.ServiceController o System.String

Puede canalizar a Stop-Service un objeto de servicio o una cadena que contiene el nombre de un servicio.

Salidas

Ninguno o System.ServiceProcess.ServiceController

Cuando se usa el parámetro PassThru, Stop-Service genera un objeto System.ServiceProcess.ServiceController que representa el servicio. En caso contrario, este cmdlet no genera resultados.

Notas

También puede hacer referencia a Stop-Service mediante su alias integrado, "spsv". Para obtener más información, vea about_Aliases.

Stop-Service solo puede controlar los servicios si el usuario actual tiene permiso para ello. Si un comando no funciona correctamente, es posible que no tenga los permisos necesarios.

Para obtener los nombres de servicio y los nombres para mostrar de los servicios del sistema, escriba "Get-Service". Los nombres de servicio aparecen en la columna Name y los nombres para mostrar aparecen en la columna DisplayName.

Ejemplo 1

C:\PS>stop-service sysmonlog

Descripción
-----------
Este comando detiene el servicio Alertas y registros de rendimiento (SysmonLog) en el equipo local.






Ejemplo 2

C:\PS>get-service -displayname telnet | stop-service

Descripción
-----------
Este comando detiene el servicio Telnet en el equipo local. El comando usa el cmdlet Get-Service para obtener un objeto que represente al servicio Telnet. El operador de canalización (|) canaliza el objeto al cmdlet Stop-Service, que detiene el servicio.






Ejemplo 3

C:\PS>get-service iisadmin | format-list -property name, dependentservices

C:PS>stop-service iisadmin -force -confirm

Descripción
-----------
El comando Stop-Service detiene el servicio IISAdmin en el equipo local. Como al detener este servicio también se detienen los servicios que dependen del servicio IISAdmin, es mejor ejecutar antes del comando Stop-Service un comando que muestre los servicios que dependan del servicio IISAdmin.

El primer comando muestra los servicios que dependen de IISAdmin. Usa el cmdlet Get-Service para obtener un objeto que represente al servicio IISAdmin. El operador de canalización (|) pasa el resultado al cmdlet Format-List. El comando usa el parámetro Property de Format-List para mostrar únicamente las propiedades Name y DependentServices del servicio.

El segundo comando detiene el servicio IISAdmin. El parámetro Force es necesario para detener un servicio que tenga servicios dependientes. El comando usa el parámetro Confirm para pedir confirmación al usuario antes de detener cada servicio.






Vea también




Tabla de contenido