Compartilhar via


Criar método da classe Win32_ScheduledJob

O método de classe CreateWMI envia um trabalho para um sistema operacional para execução em uma data e hora especificadas no futuro. Esse método exige que o serviço de agendamento seja iniciado no computador para o qual o trabalho é enviado.

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 Create(
  [in]           string   Command,
  [in]           datetime StartTime,
  [in, optional] boolean  RunRepeatedly,
  [in, optional] uint32   DaysOfWeek,
  [in, optional] uint32   DaysOfMonth,
  [in, optional] boolean  InteractWithDesktop,
  [out]          uint32   JobId
);

Parâmetros

Comando [in]

Nome do comando, programa em lote ou arquivo binário e parâmetros de linha de comando que o serviço de agendamento usa para invocar o trabalho.

Exemplo: "desfrag /q /f".

StartTime [in]

Tempo universal coordenado (UTC) para executar um trabalho. O formulário deve ser: "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", em que "YYYYMMDD" deve ser substituído por "********". Por exemplo: "*******143000.000000-420" especifica 14.30 (14:30 P.M.) PST com o horário de verão em vigor.

A seção "(+-)OOO" do valor da propriedade StartTime é o viés atual para a tradução de horário local. O viés é a diferença entre a hora UTC e a hora local. Para calcular o viés do fuso horário, multiplique o número de horas que seu fuso horário está à frente ou atrás de Greenwich Mean Time (GMT) em 60 (use um número positivo para o número de horas se o fuso horário estiver à frente do GMT e um número negativo se o fuso horário estiver atrás de GMT). Adicione mais 60 ao cálculo se o fuso horário estiver usando o horário de verão. Por exemplo, o fuso horário padrão do Pacífico está oito horas atrás do GMT, portanto, o viés é igual a -420 (-8 * 60 + 60) quando o horário de verão está em uso e -480 (-8 * 60) quando o horário de verão não está em uso. Você também pode determinar o valor do viés consultando a propriedade bias da classe Win32_TimeZone .

RunRepeatedly [in, opcional]

Se True, um trabalho agendado será executado repetidamente em dias específicos. O padrão é False.

DaysOfWeek [in, opcional]

Dias da semana em que um trabalho está agendado para ser executado; usado somente quando o parâmetro RunRepeatedly for True. Para agendar um trabalho por mais de um dia da semana, ingresse os valores apropriados em um OR lógico. Por exemplo, para agendar um trabalho para terças e sextas-feiras, o valor de DaysOfWeek é 2 OU 16.

Segunda-feira (1)

Terça-feira (2)

Quarta-feira (4)

Quinta-feira (8)

Sexta-feira (16)

Sábado (32)

Domingo (64)

DaysOfMonth [in, opcional]

Dias do mês em que um trabalho está agendado para ser executado; usado somente quando o parâmetro RunRepeatedly for True.

1 (1)

Dia 1 de um mês

2 (2)

Dia 2 de um mês

3 (4)

Dia 3 de um mês

4 (8)

Dia 4 de um mês

5 (16)

5º dia de um mês

6 (32)

Dia 6 de um mês

7 (64)

Dia 7 de um mês

8 (128)

Dia 8 de um mês

9 (256)

Dia 9 de um mês

10 (512)

Dia 10 de um mês

11 (1024)

Dia 11 de um mês

12 (2048)

Dia 12 de um mês

13 (4096)

Dia 13 de um mês

14 (8192)

Dia 14 de um mês

15 (16384)

Dia 15 de um mês

16 (32768)

Dia 16 de um mês

17 (65536)

Dia 17 de um mês

18 (131072)

Dia 18 de um mês

19 (262144)

Dia 19 de um mês

20 (524288)

Dia 20 de um mês

21 (1048576)

Dia 21 de um mês

22 (2097152)

Dia 22 de um mês

23 (4194304)

Dia 23 de um mês

24 (8388608)

Dia 24 de um mês

25 (16777216)

Dia 25 de um mês

26 (33554432)

Dia 26 de um mês

27 (67108864)

Dia 27 de um mês

28 (134217728)

Dia 28 de um mês

29 (268435456)

Dia 29 de um mês

30 (536870912)

Dia 30 de um mês

31 (1073741824)

Dia 31 de um mês

InteractWithDesktop [in, opcional]

Se True, o trabalho especificado deverá ser interativo, o que significa que um usuário pode fornecer entrada para um trabalho agendado enquanto o trabalho está em execução. O padrão é False.

JobId [out]

Número de identificador de um trabalho. Esse parâmetro é um identificador para um trabalho que está sendo agendado em um computador.

Valor retornado

Retorna um valor de 0 (zero) quando bem-sucedido e um número diferente 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.

Conclusão bem-sucedida

0

A solicitação é aceita.

Sem suporte

1

A solicitação não terá suporte.

Acesso negado

2

O usuário não tem o acesso necessário.

Falha desconhecida

8

Processo interativo.

Demarcador não localizado

9

O caminho do diretório para o arquivo executável do serviço não pode ser encontrado.

Parâmetro inválido

21

Parâmetros inválidos foram passados para o serviço.

Serviço não iniciado

22

A conta em que esse serviço é executado é inválida ou não tem as permissões para executar o serviço.

Outros

23 4294967295

Comentários

Se o trabalho agendado iniciar um programa interativo, como o Bloco de Notas, a propriedade InteractWithDeskto deverá ser definida como True ou a tela do programa não estará visível. O processo ainda aparece no Gerenciador de Tarefas , mesmo que não apareça na tela.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_ScheduledJob