Compartir a través de

Suspend-Service

Módulo:
Microsoft.PowerShell.Management Module

Suspende (pausa) uno o más servicios en ejecución.

Sintaxis

InputObject (Es el valor predeterminado). 

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

Default 

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

DisplayName 

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

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 sigue en ejecución, 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

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

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

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

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 suspender. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

DisplayName
Posición:Named
Mandatory: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 se omitirán de los servicios especificados. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 se suspenderán. El valor de este parámetro condiciona el parámetro Name. Escriba un elemento o patrón de nombre, como "s*". Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 suspenderán. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.

Propiedades del parámetro

Tipo:

ServiceController[]

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

Conjuntos de parámetros

InputObject
Posición:0
Mandatory: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 suspenderán. Se permite el uso de 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.

Propiedades del parámetro

Tipo:

String[]

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

Conjuntos de parámetros

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

-PassThru

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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

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, 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 Name y los nombres para mostrar aparecen en la columna DisplayName.