Stop-Service
Detiene uno o más servicios en ejecución.
Syntax
Stop-Service
[-Force]
[-NoWait]
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-Service
[-Force]
[-NoWait]
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet solo está disponible en la plataforma Windows.
El Stop-Service
cmdlet envía un mensaje de detención al controlador de servicio de Windows para cada uno de los servicios especificados. Puede especificar los servicios por sus nombres de servicio o nombres para mostrar, o bien puede usar el parámetro InputObject para pasar un objeto de servicio que represente el servicio que desea detener.
Ejemplos
Ejemplo 1: Detener un servicio en el equipo local
PS C:\> Stop-Service -Name "sysmonlog"
Este comando detiene el servicio Registros y alertas de rendimiento (SysmonLog) en el equipo local.
Ejemplo 2: Detener un servicio mediante el nombre para mostrar
PS C:\> Get-Service -DisplayName "telnet" | Stop-Service
Este comando detiene el servicio Telnet en el equipo local. El comando usa Get-Service
para obtener un objeto que representa el servicio Telnet. El operador de canalización (|
) canaliza el objeto a Stop-Service
, que detiene el servicio.
Ejemplo 3: Detener un servicio que tenga servicios dependientes
PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm
En este ejemplo se detiene el servicio IIS Administración en el equipo local. Dado que detener este servicio también detiene los servicios que dependen del servicio IIS Administración, es mejor preceder Stop-Service
a un comando que muestre los servicios que dependen del servicio IIS Administración.
El primer comando enumera los servicios que dependen de IISAdmin. Usa Get-Service
para obtener un objeto que representa el servicio IIS Administración. El operador de canalización (|
) pasa el resultado al Format-List
cmdlet . El comando usa el parámetro Property de Format-List
para enumerar solo 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 solicitar confirmación del usuario antes de detener cada servicio.
Parámetros
-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 |
-DisplayName
Especifica los nombres para mostrar de los servicios que se van a detener. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Especifica los servicios que este cmdlet omite. El valor de este parámetro califica el parámetro Name . Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Obliga al cmdlet a detener un servicio incluso si ese servicio tiene servicios dependientes.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Especifica los servicios que este cmdlet detiene. El valor de este parámetro califica el parámetro Name . Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Especifica los objetos ServiceController que representan los servicios que se van a detener. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica los nombres de servicio de los servicios que se van a detener. Se permite el uso de caracteres comodín.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoWait
Indica que este cmdlet usa la opción sin espera.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera ningún resultado.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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
Puede canalizar un objeto de servicio a este cmdlet.
Puede canalizar una cadena que contenga el nombre de un servicio a este cmdlet.
Salidas
None
De forma predeterminada, este cmdlet no devuelve ninguna salida.
Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto ServiceController que representa el servicio.
Notas
PowerShell incluye los siguientes alias para Stop-Service
:
- Windows:
spsv
Este cmdlet solo está disponible en plataformas Windows.
Stop-Service
solo puede controlar los servicios cuando el usuario actual tiene permiso para hacerlo. Si un comando no funciona correctamente, puede que se deba a que no tiene los permisos necesarios.
Para buscar los nombres de servicio y los nombres para mostrar de los servicios en el sistema, escriba Get-Service
. Los nombres de servicio aparecen en la columna Nombre y los nombres para mostrar aparecen en la columna DisplayName .
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