Compartir a través de

Stop-Service

Módulo:
Microsoft.PowerShell.Management Module

Detiene uno o varios servicios en ejecución.

Sintaxis

InputObject (valor predeterminado) 

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

Default 

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

DisplayName 

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

Description

El cmdlet Stop-Service 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 de rendimiento y alertas (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 para 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 IISAdmin en el equipo local. Dado que detener este servicio también detiene los servicios que dependen del servicio IISAdmin, es mejor preceder a Stop-Service con un comando que enumera los servicios que dependen del servicio IISAdmin.

El primer comando enumera los servicios que dependen de IISAdmin. Usa get-service para obtener un objeto que representa el 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 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 la confirmación del usuario antes de detener cada servicio.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

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

-DisplayName

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

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

-Exclude

Especifica los servicios que este cmdlet omite. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
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

-Force

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

Propiedades de parámetro

Tipo:SwitchParameter
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

-Include

Especifica los servicios que este cmdlet detiene. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento de nombre o patrón, como s*. Se permite el uso de caracteres comodín.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
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

-InputObject

Especifica ServiceController objetos que representan los servicios que se van a detener. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.

Propiedades de parámetro

Tipo:

ServiceController[]

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

Conjuntos de parámetros

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

-Name

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

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False
Alias:NombreDelServicio

Conjuntos de parámetros

Default
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

-NoWait

Indica que este cmdlet usa la opción sin espera.

Propiedades de parámetro

Tipo:SwitchParameter
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

-PassThru

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

Propiedades de parámetro

Tipo:SwitchParameter
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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. 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 canalizar un objeto de servicio o una cadena que contenga el nombre de un servicio a este cmdlet.

Salidas

None, System.ServiceProcess.ServiceController

Este cmdlet genera un objeto System.ServiceProcess.ServiceController que representa el servicio, si usa el parámetro PassThru. De lo contrario, este cmdlet no genera ninguna salida.

Notas

  • También puede hacer referencia a stop-Service por su alias integrado, spsv. Para obtener más información, consulte about_Aliases.

    Stop-Service solo puede controlar los servicios cuando el usuario actual tiene permiso para hacerlo. Si un comando no funciona correctamente, es posible que no tenga 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 .