Compartir a través de

Suspend-Service

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Suspende (pausa) uno o varios servicios en ejecución.

Sintaxis

Suspend-Service
       [-InputObject] <ServiceController[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-Name] <String[]>
       [-PassThru]
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Suspend-Service
       [-PassThru]
       -DisplayName <String[]>
       [-Include <String[]>]
       [-Exclude <String[]>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Suspend-Service envía un mensaje de suspensión al controlador de servicio de Windows para cada uno de los servicios especificados. Mientras se suspende, el servicio todavía se está ejecutando, pero su acción se detiene hasta que se reanuda, como mediante el cmdlet Resume-Service. 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 los servicios que desea suspender.

Ejemplos

Ejemplo 1: Suspender un servicio

PS C:\> Suspend-Service -DisplayName "Telnet"

Este comando suspende el servicio Telnet (Tlntsvr) en el equipo local.

Ejemplo 2: Mostrar lo que sucedería si suspende los servicios

PS C:\> Suspend-Service -Name lanman* -WhatIf

Este comando indica lo que sucedería si suspendiera los servicios que tienen un nombre de servicio que comienza con lanman. Para suspender los servicios, vuelva a ejecutar el comando sin el parámetro WhatIf.

Ejemplo 3: Obtener y suspender un servicio

PS C:\> Get-Service schedule | Suspend-Service

Este comando usa el cmdlet Get-Service para obtener un objeto que representa el servicio Programador de tareas (Programación) en el equipo. El operador de canalización (|) pasa el resultado a Suspend-Service, que suspende el servicio.

Ejemplo 4: Suspender todos los servicios que se pueden suspender

PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm

Este comando suspende todos los servicios del equipo que se pueden suspender. Usa Get-Service para obtener objetos que representan los servicios del equipo. El operador de canalización pasa los resultados al cmdlet Where-Object, que selecciona solo los servicios que tienen un valor de $True para la propiedad CanPauseAndContinue. Otro operador de canalización pasa los resultados a Suspend-Service. El parámetro Confirm solicita confirmación antes de suspender cada uno de los servicios.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Especifica los nombres para mostrar de los servicios que se van a suspender. Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Exclude

Especifica los servicios que se omitirán de los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Include

Especifica los servicios que se suspenderán. El valor de este parámetro califica el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-InputObject

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

Tipo:ServiceController[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica los nombres de servicio de los servicios que se suspenderán. Se permiten caracteres comodín.

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

Tipo:String[]
Alias:ServiceName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.ServiceProcess.ServiceController, System.String

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

Salidas

None, System.ServiceProcess.ServiceController

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

Notas

  • Suspend-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.
  • Suspend-Service solo puede suspender los servicios que admiten la suspensión y reanudación. Para determinar si se puede suspender un servicio determinado, use el cmdlet Get-Service junto con la propiedad CanPauseAndContinue. Por ejemplo, Get-Service wmi | Format-List Name, CanPauseAndContinue. Para buscar todos los servicios del equipo que se pueden suspender, escriba Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • 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 de y los nombres para mostrar aparecen en la columna DisplayName de .