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	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

Clases de sistema operativo

Win32_Service

Tareas de WMI: servicios