Classe Win32_ScheduledJob

  • Artigo

A classe WMIWin32_ScheduledJob representa um trabalho criado com o comando AT.

Observação

A classe Win32_ScheduledJob não representa um trabalho criado com o Assistente de Tarefa Agendada do Painel de Controle. Não é possível alterar uma tarefa criada pelo WMI na interface do usuário de Tarefas Agendadas. Para obter mais informações, consulte a seção Comentários.

 

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Membros

A classe Win32_ScheduledJob tem estes tipos de membros:

Métodos

A classe Win32_ScheduledJob tem esses métodos.

Método Descrição
Criar Método de classe que envia um trabalho para o sistema operacional para execução em uma data e hora futura especificadas.
Excluir Método de classe que exclui um trabalho agendado.

 

Propriedades

A classe Win32_ScheduledJob tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Comando

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_INFO Command")

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

Exemplo: "defrag/q/f"

DaysOfMonth

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_INFO DaysOfMonth")

Dias do mês em que o trabalho está agendado para ser executado. Se um trabalho estiver agendado para ser executado em vários dias do mês, esses valores poderão ser unidos em um OR lógico. Por exemplo, se um trabalho for executado nos dias 1º e 16 de cada mês, o valor da propriedade DaysOfMonth será 1 OU 32768.

1 (1)

1º

2 (2)

2º

3 (4)

3a.

4 (8)

4a.

5 (16)

5º

6 (32)

6º

7 (64)

Dia 7.

8 (128)

Dia 8.

9 (256)

Dia 9.

10 (512)

Dia 10.

11 (1024)

11º

12 (2048)

12º

13 (4096)

13º

14 (8192)

Dia 14.

15 (16384)

Dia 15.

16 (32768)

Dia 16.

17 (65536)

Dia 17.

18 (131072)

Dia 18.

19 (262144)

Xix

20 (524288)

Dia 20.

21 (1048576)

21º

22 (2097152)

22º

23 (4194304)

23º

24 (8388608)

Dia 24.

25 (16777216)

Dia 25.

26 (33554432)

Dia 26.

27 (67108864)

Dia 27.

28 (134217728)

Dia 28.

29 (268435456)

Dia 29.

30 (536870912)

30º

31 (1073741824)

31º

DaysOfWeek

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_INFO DaysOfWeek")

Dias da semana em que um trabalho está agendado para ser executado. Se um trabalho estiver agendado para ser executado em vários dias da semana, os valores poderão ser unidos em um OR lógico. Por exemplo, se um trabalho estiver agendado para ser executado às segundas, quartas e sextas-feiras, o valor da propriedade DaysOfWeek será 1 OU 4 OU 16.

Segunda-feira (1)

Terça-feira (2)

Quarta-feira (4)

Quinta-feira (8)

Sexta-feira (16)

Sábado (32)

Domingo (64)

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

ElapsedTime

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Período de tempo em que o trabalho foi executado.

Essa propriedade é herdada de CIM_Job.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InteractWithDesktop

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_INFO Sinalizadores|JOB_NONINTERACTIVE")

O trabalho especificado é interativo, o que significa que um usuário pode dar entrada a um trabalho agendado enquanto ele está em execução.

Jobid

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Key, MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_ENUM JobId")

Identificando o número do trabalho. Ele é usado por métodos como um identificador para um trabalho que está sendo agendado neste computador.

JobStatus

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("JobStatus"), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_ENUM Sinalizadores|JOB_EXEC_ERROR")

Status da execução na última vez em que este trabalho foi agendado para ser executado.

Sucesso ("Êxito")

Falha ("Falha")

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Notificar

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O usuário é notificado após a conclusão ou falha do trabalho.

Essa propriedade é herdada de CIM_Job.

Proprietário

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Usuário que enviou o trabalho.

Essa propriedade é herdada de CIM_Job.

Prioridade

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Importância da execução de um trabalho.

Essa propriedade é herdada de CIM_Job.

RunRepeatedly

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_INFO Sinalizadores|JOB_RUN_PERIODICALLY")

O trabalho agendado é executado repetidamente nos dias em que o trabalho está agendado. Se False, o trabalho será executado uma vez.

StartTime

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("StartTime"), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| | AT_ENUM JobTime")

Hora UTC para executar o trabalho, na forma de "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", em que "AAAAMMDD" deve ser substituído por "********". A substituição é necessária porque o serviço de agendamento só permite que os trabalhos sejam configurados para serem executados uma vez ou executados em um dia do mês ou da semana. Um trabalho não pode ser executado em uma data específica.

A seção "(+-)OOO" do valor da propriedade StartTime é o viés atual para a tradução de hora local. O desvio é a diferença entre a hora UTC e a hora local. Para calcular o desvio para seu fuso horário, multiplique o número de horas que seu fuso horário está à frente ou atrás de Gmt (Horário de Greenwich) por 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 de GMT, portanto, o desvio é 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 desvio consultando a propriedade bias da classe Win32_TimeZone .

Por exemplo: "*******123000.000000-420" especifica 14,30 (14:30 P.M.) PST com o horário de verão em vigor.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. As status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

TimeSubmitted

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Hora em que o trabalho foi enviado.

Essa propriedade é herdada de CIM_Job.

UntilTime

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Hora em que o trabalho é inválido ou deve ser interrompido.

Essa propriedade é herdada de CIM_Job.

Comentários

Cada trabalho agendado no serviço de agendamento é armazenado persistentemente (o agendador pode iniciar um trabalho após uma reinicialização) e é executado na hora e no dia especificados da semana ou do mês. Se o computador não estiver ativo ou se o serviço agendado não estiver em execução no momento do trabalho especificado, o serviço de agendamento executará o trabalho especificado no dia seguinte no horário especificado.

Os trabalhos são agendados de acordo com o UTC (Tempo Universal Coordenado) com deslocamento de desvio do GMT (Horário de Greenwich), o que significa que um trabalho pode ser especificado usando qualquer fuso horário. A classe Win32_ScheduledJob retorna a hora local com deslocamento UTC ao enumerar um objeto e converte em hora local ao criar novos trabalhos. Por exemplo, um trabalho especificado para ser executado em um computador em Boston às 22h30 de segunda-feira horário do PST será agendado para ser executado localmente à 1:30 da manhã de terça-feira EST.

Observação

Um cliente deve levar em conta se o horário de verão está ou não em operação no computador local e, se estiver, subtraia um desvio de 60 minutos do deslocamento UTC.

 

A classe Win32_ScheduledJob é derivada de CIM_Job. Você deve ser um membro do grupo de administradores para criar um trabalho agendado usando essa classe.

A classe Win32_ScheduledJob está usando internamente o protocolo AT, que está associado à substituição começando com Windows 8 e Windows Server 2012. Como primeira etapa, o protocolo AT é desabilitado por padrão. Se o protocolo estiver desabilitado, por exemplo, chamar o método Create em um objeto Win32_ScheduledJob falhará com o erro 0x8. Você pode ativar o protocolo AT novamente adicionando a seguinte entrada do Registro:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Talvez seja necessário reiniciar o computador para tornar a configuração eficaz.

Como Win32_ScheduledJob se baseia na API NetScheduleJobGetInfo Win32, você não pode usar essa classe em conjunto com o Agendador de Tarefas. Se você quiser usar o Agendador de Tarefas, use a API do Agendador de Tarefas. Para obter mais informações, consulte a Referência do Agendador de Tarefas.

Exemplos

O exemplo de código VBScript a seguir agenda Notepad.exe para ser executado interativamente às 1:25 pela hora do computador local todas as quartas-feiras.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

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

CIM_Job

Classes do sistema operacional

Tarefas WMI: Tarefas Agendadas