Suspende (pausa) uno o más servicios en ejecución.
Sintaxis
Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Suspend-Service envía un mensaje de suspensión al controlador de servicios de Windows para cada uno de los servicios especificados. Mientras esté suspendido, el servicio seguirá ejecutándose aunque su acción esté detenida hasta que se reanude (por ejemplo, mediante el uso de Resume-Service). Se pueden especificar los servicios por su nombre de servicio o por su nombre para mostrar, o se puede usar el parámetro InputObject para pasar un objeto de servicio que represente los servicios que se desea suspender.
Parámetros
-DisplayName <string[]>
Especifica los nombres para mostrar de los servicios que se van a suspender. Se permite el uso de caracteres comodín.
|
¿Requerido? |
true |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Exclude <string[]>
Omite los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Suspende únicamente los servicios especificados. El valor de este parámetro califica el parámetro Name. Escriba un patrón o un elemento del nombre, como "s*". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-InputObject <ServiceController[]>
Especifica objetos ServiceController que representan los servicios que se van a suspender. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue) |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica los nombres de los servicios que se van a suspender. Se permite el uso de caracteres comodín.
El nombre del parámetro es opcional. Puede usar "Name" o su alias, "ServiceName", o bien, puede omitir el nombre del parámetro.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PassThru
Devuelve un objeto que representa el servicio. De forma predeterminada, este cmdlet no genera resultados.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
System.ServiceProcess.ServiceController o System.String Puede canalizar a Suspend-Service un objeto de servicio o una cadena que contiene un nombre de servicio. |
|
Salidas |
Ninguno o System.ServiceProcess.ServiceController Cuando se usa el parámetro PassThru, Suspend-Service genera un objeto System.ServiceProcess.ServiceController que representa el servicio. En caso contrario, este cmdlet no genera resultados. |
Notas
Suspend-Service solo puede controlar los servicios si el usuario actual tiene permiso para ello. Si un comando no funciona correctamente, es posible que no tenga los permisos necesarios.
Además, Suspend-Service solo puede suspender servicios que se puedan suspender y reanudar. Para determinar si un servicio determinado se puede suspender, use el cmdlet Get-Service 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 obtener los nombres de servicio y los nombres para mostrar de los servicios del sistema, escriba "Get-Service". Los nombres de servicio aparecen en la columna Name y los nombres para mostrar aparecen en la columna DisplayName.
Ejemplo 1
C:\PS>suspend-service -displayname "Telnet" Descripción ----------- Este comando suspende el servicio Telnet (Tlntsvr) en el equipo local.
Ejemplo 2
C:\PS>suspend-service -name lanman* -whatif Descripción ----------- Este comando indica lo que sucedería si se suspendieran los servicios con un nombre de servicio que empezase por "lanman". Para suspender los servicios, vuelva a ejecutar el comando sin el parámetro WhatIf.
Ejemplo 3
C:\PS>get-service schedule | suspend-service Descripción ----------- Este comando usa el cmdlet Get-Service para obtener un objeto que represente al servicio Programador de tareas (Schedule) en el equipo. El operador de canalización (|) pasa el resultado al cmdlet Suspend-Service, que suspende el servicio.
Ejemplo 4
C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm
Descripción
-----------
Este comando suspende todos los servicios del equipo que se pueden suspender. Usa el cmdlet Get-Service para obtener los objetos que representan los servicios de un equipo. El operador de canalización (|) pasa los resultados al cmdlet Where-Object, que selecciona únicamente los servicios para los que el valor de la propiedad CanPauseAndContinue sea "True". Otro operador de canalización (|) pasa los resultados al cmdlet Suspend-Service. El parámetro Confirm pide una confirmación antes de suspender cada servicio.
Vea también