Método StartService de la clase Win32_Service (proveedores WMI CIMWin32)
El método StartService intenta colocar el servicio al que se hace referencia en su estado de inicio.
En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.
Sintaxis
uint32 StartService();
Parámetros
Este método no tiene parámetros.
Valor devuelto
Devuelve uno de los valores enumerados en la lista siguiente o cualquier otro valor para indicar un error. Para obtener códigos de error adicionales, consulte Constantes de error de WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.
-
0
-
Se aceptó la solicitud.
-
1
-
No se admite la solicitud.
-
2
-
El usuario no tenía el acceso necesario.
-
3
-
No se puede detener el servicio porque otros servicios que se están ejecutando dependen de él.
-
4
-
El código de control solicitado no es válido o no es aceptable para el servicio.
-
5
-
El código de control solicitado no se puede enviar al servicio porque el estado del servicio (Win32_BaseService. Propiedad State ) es igual a 0, 1 o 2.
-
6
-
El servicio no se ha iniciado.
-
7
-
El servicio no respondió a tiempo a la solicitud de inicio.
-
8
-
Error desconocido al iniciar el servicio.
-
9
-
No se encontró la ruta de acceso del directorio al archivo ejecutable del servicio.
-
10
-
El servicio ya se está ejecutando.
-
11
-
La base de datos para agregar un nuevo servicio está bloqueada.
-
12
-
Una dependencia en la que se basa este servicio se ha quitado del sistema.
-
13
-
El servicio no pudo encontrar el servicio necesario de un servicio dependiente.
-
14
-
El servicio se ha deshabilitado del sistema.
-
15
-
El servicio no tiene la autenticación correcta para ejecutarse en el sistema.
-
16
-
Este servicio se está quitando del sistema.
-
17
-
El servicio no tiene ningún subproceso de ejecución.
-
18
-
El servicio tiene dependencias circulares cuando se inicia.
-
19
-
Un servicio se ejecuta con el mismo nombre.
-
20
-
El nombre del servicio tiene caracteres no válidos.
-
21
-
Se han pasado parámetros no válidos al servicio.
-
22
-
La cuenta con la que se ejecuta este servicio no es válida o carece de los permisos para ejecutar el servicio.
-
23
-
El servicio existe en la base de datos de servicios disponibles del sistema.
-
24
-
El servicio se encuentra en pausa actualmente en el sistema.
Comentarios
Aunque puede parecer que no hay ninguna diferencia práctica entre un servicio detenido y un servicio que está en pausa, los dos estados aparecen de forma diferente al SCM. Un servicio detenido es un servicio que no se está ejecutando y que debe pasar por todo el procedimiento de inicio del servicio. Sin embargo, un servicio en pausa sigue en ejecución, pero ha tenido su funcionamiento suspendido. Por este motivo, un servicio en pausa no necesita pasar por todo el procedimiento de inicio del servicio, pero necesita otro procedimiento para reanudar el funcionamiento.
Debe usar el método adecuado para iniciar un servicio que se ha detenido o para reanudar un servicio que se ha pausado. Los métodos Win32_ServiceStartService y ResumeService deben usarse en las situaciones siguientes:
- Si un servicio está detenido actualmente, debe usar el método StartService para reiniciarlo; ResumeService no puede iniciar un servicio que está detenido actualmente.
- Si un servicio está en pausa, debe usar ResumeService. Si usa el método StartService en un servicio en pausa, recibirá el mensaje "El servicio ya está en ejecución". Sin embargo, el servicio permanece en pausa hasta que se envía el código de control del servicio de reanudación.
Si inicia un servicio detenido que depende de otro servicio, se inician ambos servicios. Cuando se inicia un servicio con este método, los servicios dependientes no se inician automáticamente. Debe usar la clase de asociación Win32_DependentService y la consulta Asociadores de para buscar los dependientes e iniciarlos por separado.
Ejemplos
El ejemplo de PowerShell de Habilitación remota de RDP habilita de forma remota el servicio Escritorio remoto.
El ejemplo Stop, Start, Enable o Disable Service PowerShell se inicia, detiene, habilita o deshabilita un servicio.
En el ejemplo de código VBSScript siguiente se muestra cómo iniciar un servicio específico a partir de instancias de Win32_Service.
Set ServiceSet = GetObject("winmgmts:").ExecQuery("select * from Win32_Service where Name='ClipSrv'")
for each Service in ServiceSet
RetVal = Service.StartService()
if RetVal = 0 then WScript.Echo "Service started"
if RetVal = 10 then WScript.Echo "Service already running"
next
En el ejemplo de código perl siguiente se muestra cómo iniciar un servicio específico a partir de instancias de Win32_Service.
use strict;
use Win32::OLE;
my $ServiceSet;
eval { $ServiceSet =
Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2")->
ExecQuery("SELECT * FROM Win32_Service WHERE Name='ClipSrv'"); };
if(!$@ && defined $ServiceSet)
{
foreach my $service (in $ServiceSet)
{
my $Result = $service->StartService();
if ($Result == 0)
{
print "\nService started\n";
}
elsif ($Result == 10)
{
print "\nService already running\n";
}
}
}
else
{
print STDERR Win32::OLE->LastError, "\n";
}
El siguiente ejemplo de código vbScript, NetDDE, depende del servicio NetDDEDSDM. El script localiza la clase en la que NetDDE depende y la inicia, lo que no inicia Automáticamente NetDDE.
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
' Stop NetDDE if it is running
Set objNetDDEService = objWMIService.Get("Win32_Service.Name='NetDDE'")
Return = objNetDDEService.StopService()
' NetDDE is in the dependent role to another service
Set colServiceList = objWMIService.ExecQuery("Associators of " _
& "{Win32_Service.Name='NetDDE'} Where " & "AssocClass=Win32_DependentService " & "Role=Dependent" )
' start the service on which NetDDE is dependent
For Each objService in colServiceList
WScript.Echo "Starting " & objService.Name
Return = objService.StartService()
If Return = 0 Then
WScript.Echo "Parent service " & objService.Name & " started successfully"
Else
WScript.Echo "Parent service " & objService.Name & " did not start. Return = " & Return
End If
Next
' NetDDE is still stopped
Set objNetDDEService = _
objWMIService.Get("Win32_Service.Name='NetDDE'")
WScript.Echo "Dependent NetDDE service is " & objNetDDEService.State
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|