Método ChangeStartMode da classe Win32_Service (Provedores WMI CIMWin32)
O método de classe WMIChangeStartMode modifica o modo inicial de um Win32_Service.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
Parâmetros
-
StartMode [in]
-
Modo inicial do serviço base do Windows.
-
Inicialização inicial ("Inicialização")
-
Driver de dispositivo iniciado pelo carregador do sistema operacional. Esse valor só é válido para serviços do driver.
-
Sistema ("Sistema")
-
Driver de dispositivo iniciado pelo processo de inicialização do sistema operacional. Esse valor só é válido para serviços do driver.
-
Início Automático ("Automático")
-
Serviço a ser iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema.
-
Início da Demanda ("Manual")
-
Serviço a ser iniciado pelo gerenciador de controle de serviço quando um processo chama o método StartService .
-
Desabilitado ("Desabilitado")
-
Serviço que não pode mais ser iniciado.
Valor retornado
Retorna um dos valores listados na lista a seguir ou qualquer outro valor para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
Êxito
-
0
A solicitação foi aceita.
-
Sem suporte
-
1
A solicitação não terá suporte.
-
Acesso negado
-
2
O usuário não tinha o acesso necessário.
-
Serviços dependentes em execução
-
3
O serviço não pode ser interrompido, porque outros serviços em execução dependem dele.
-
Controle de Serviço Inválido
-
4
O código de controle pedido não é válido ou é inaceitável para o serviço.
-
O serviço não pode aceitar o controle
-
5
O código de controle solicitado não pode ser enviado ao serviço porque o estado do serviço (Win32_BaseService. Propriedade State ) é igual a 0, 1 ou 2.
-
Serviço Não Ativo
-
6
O serviço não foi iniciado.
-
Tempo limite da solicitação de serviço
-
7
O serviço não respondeu à solicitação de início em um tempo oportuno.
-
Falha desconhecida
-
8
Falha desconhecida ao iniciar o serviço.
-
Caminho não encontrado
-
9
O caminho do diretório para o arquivo executável do serviço não foi encontrado.
-
Serviço já em execução
-
10
O serviço já está em execução.
-
Banco de Dados de Serviço Bloqueado
-
11
O banco de dados para adicionar um serviço novo está bloqueado.
-
Dependência de serviço excluída
-
12
Uma dependência em que esse serviço depende foi removida do sistema.
-
Falha na dependência do serviço
-
13
O serviço não localizou o serviço necessário em um serviço dependente.
-
Serviço Desabilitado
-
14
O serviço foi desabilitado do sistema.
-
Falha no logon do serviço
-
15
O serviço não tem a autenticação correta para ser executado no sistema.
-
Serviço marcado para exclusão
-
16
Esse serviço está sendo removido do sistema.
-
Serviço Sem Thread
-
17
O serviço não tem thread de execução.
-
Dependência circular de status
-
18
O serviço tem dependências circulares quando é iniciado.
-
Nome duplicado de status
-
19
Um serviço está em execução com o mesmo nome.
-
Nome inválido de status
-
20
O nome do serviço tem caracteres inválidos.
-
Parâmetro status inválido
-
21
Parâmetros inválidos foram passados para o serviço.
-
Conta de serviço inválida de status
-
22
A conta sob a qual esse serviço é executado é inválida ou não tem as permissões para executar o serviço.
-
O Serviço de Status existe
-
23
O serviço existe no banco de dados de serviços disponível no sistema.
-
Serviço já pausado
-
24
O serviço está pausado atualmente no sistema.
-
Outros
-
25 4294967295
Exemplos
O seguinte exemplo alterar o StartMode de um PowerShell de serviço , extraído da Galeria do TechNet, altera o modo de início de um serviço.
$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 | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|