Compartir a través de

Suspend-Service

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Suspende (pausa) uno o más 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

Este cmdlet solo está disponible en la plataforma Windows.

El Suspend-Service cmdlet 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 Resume-Service cmdlet . 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 Get-Service cmdlet 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 en el equipo que se pueden suspender. Get-Service Usa para obtener objetos que representan los servicios del equipo. El operador de canalización pasa los resultados al Where-Object cmdlet , que selecciona solo los servicios que tienen un valor para $True la propiedad CanPauseAndContinue . Otro operador de canalización pasa los resultados a Suspend-Service. El parámetro Confirm le pide confirmación antes de suspender cada uno de los servicios.

Parámetros

-Confirm

Le solicita su 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 permite el uso de 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 permite el uso de 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 permite el uso de 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 los objetos ServiceController que representan los servicios que se van a suspender. Especifique una variable que contenga los objetos o escriba un comando o una 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 permite el uso de caracteres comodín.

El nombre de parámetro es opcional. Puede usar Name 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 ningún resultado.

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 se ejecutara el cmdlet. 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

ServiceController

Puede canalizar un objeto de servicio a este cmdlet.

String

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

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

ServiceController

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto ServiceController que representa el servicio.

Notas

Este cmdlet solo está disponible en plataformas Windows.

  • Suspend-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.
  • 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 Get-Service cmdlet 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 y los nombres para mostrar aparecen en la columna DisplayName .