Método ChangeStartMode de la clase Win32_Service (proveedores WMI CIMWin32)
El método de clase WMIChangeStartMode modifica el modo de inicio de un Win32_Service.
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 ChangeStartMode(
[in] string StartMode = Auto Start
);
Parámetros
-
StartMode [in]
-
Modo de inicio del servicio base de Windows.
-
Inicio de arranque ("Arranque")
-
Controlador de dispositivo iniciado por el cargador del sistema operativo. Este valor solamente es válido para servicios de controladores.
-
Sistema ("Sistema")
-
Controlador de dispositivo iniciado por el proceso de inicialización del sistema operativo. Este valor solamente es válido para servicios de controladores.
-
Inicio automático ("Automático")
-
Servicio que el administrador de control de servicios iniciará automáticamente durante el inicio del sistema.
-
Inicio de la demanda ("Manual")
-
El administrador de control de servicios iniciará el servicio cuando un proceso llama al método StartService .
-
Deshabilitado ("Deshabilitado ")
-
Servicio que ya no se puede iniciar.
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.
-
Success
-
0
Se aceptó la solicitud.
-
No compatible
-
1
No se admite la solicitud.
-
Acceso denegado
-
2
El usuario no tenía el acceso necesario.
-
Servicios dependientes en ejecución
-
3
No se puede detener el servicio porque otros servicios que se están ejecutando dependen de él.
-
Control de servicio no válido
-
4
El código de control solicitado no es válido o no es aceptable para el servicio.
-
El servicio no puede aceptar el control
-
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.
-
Servicio no activo
-
6
El servicio no se ha iniciado.
-
Tiempo de espera de solicitud de servicio
-
7
El servicio no respondió a tiempo a la solicitud de inicio.
-
Error desconocido
-
8
Error desconocido al iniciar el servicio.
-
Ruta de acceso no encontrada
-
9
No se encontró la ruta de acceso del directorio al archivo ejecutable del servicio.
-
Servicio que ya se está ejecutando
-
10
El servicio ya se está ejecutando.
-
Base de datos de servicio bloqueada
-
11
La base de datos para agregar un nuevo servicio está bloqueada.
-
Dependencia de servicio eliminada
-
12
Una dependencia en la que se basa este servicio se ha quitado del sistema.
-
Error de dependencia del servicio
-
13
El servicio no pudo encontrar el servicio necesario de un servicio dependiente.
-
Servicio deshabilitado
-
14
El servicio se ha deshabilitado del sistema.
-
Error de inicio de sesión de servicio
-
15
El servicio no tiene la autenticación correcta para ejecutarse en el sistema.
-
Servicio marcado para eliminación
-
16
Este servicio se está quitando del sistema.
-
Servicio sin subproceso
-
17
El servicio no tiene ningún subproceso de ejecución.
-
Dependencia circular de estado
-
18
El servicio tiene dependencias circulares cuando se inicia.
-
Nombre duplicado de estado
-
19
Un servicio se ejecuta con el mismo nombre.
-
Estado Nombre no válido
-
20
El nombre del servicio tiene caracteres no válidos.
-
Parámetro no válido de estado
-
21
Se han pasado parámetros no válidos al servicio.
-
Estado Cuenta de servicio no válida
-
22
La cuenta con la que se ejecuta este servicio no es válida o carece de los permisos para ejecutar el servicio.
-
El servicio de estado existe
-
23
El servicio existe en la base de datos de servicios disponibles del sistema.
-
El servicio ya está en pausa
-
24
El servicio se encuentra en pausa actualmente en el sistema.
-
Otros
-
25 4294967295
Ejemplos
El siguiente ejemplo change StartMode de un servicio de PowerShell, extraído de la Galería de TechNet, cambia el modo de inicio de un servicio.
$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon |
where-object { $_.name -eq 'bits' }
$rtn = $wmi.changestartmode("manual")
if($rtn.returnvalue -eq 0) { "success" }
ELSE
{ " $($rtn.returnvalue) was reported" }
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|