classe Msvm_ConcreteJob

Artigo
06/13/2023

Uma versão concreta do trabalho. Essa classe representa uma unidade de trabalho genérica e instanciável, como um lote ou um trabalho de impressão, e é usada especificamente no Hyper-V para acompanhar o progresso das operações assíncronas.

A sintaxe a seguir é o código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ConcreteJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   JobStatus;
  datetime TimeSubmitted;
  datetime ScheduledStartTime;
  datetime StartTime;
  datetime ElapsedTime;
  uint32   JobRunTimes;
  uint8    RunMonth;
  sint8    RunDay;
  sint8    RunDayOfWeek;
  datetime RunStartInterval;
  uint16   LocalOrUtcTime;
  datetime UntilTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  uint16   PercentComplete;
  boolean  DeleteOnCompletion;
  uint16   ErrorCode;
  string   ErrorDescription;
  string   ErrorSummaryDescription;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 
                00000000000500.000000:000
              ;
  boolean  Cancellable;
  uint16   JobType;
};

Membros

A classe Msvm_ConcreteJob tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Msvm_ConcreteJob tem esses métodos.

Método	Descrição
GetError	Recupera o objeto de erro para o trabalho, se houver um.
GetErrorEx	Recupera os objetos de erro para o trabalho, se houver algum.
KillJob	Não há suporte para o método.
RequestStateChange	Solicita que o estado do trabalho seja alterado para o estado especificado.

Propriedades

A classe Msvm_ConcreteJob tem essas propriedades.

Cancelável

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Indica se o trabalho pode ser cancelado. O valor dessa propriedade não garante que uma solicitação para cancelar o trabalho seja bem-sucedida.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement.

CommunicationStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com o elemento gerenciado subjacente. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

DeleteOnCompletion

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Especifica se o trabalho deve ser excluído automaticamente após a conclusão. Essa propriedade é herdada de CIM_Job.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement.

DetailedStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes adicionais de status. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

ElapsedTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

O intervalo de tempo que o trabalho está executando ou o tempo total de execução se o trabalho for concluído. Essa propriedade é herdada de CIM_Job.

ElementName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade é herdada de CIM_ManagedElement.

ErrorCode

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Um código de erro específico do fornecedor. O valor deverá ser definido como zero se o trabalho for concluído sem erro. Essa propriedade é herdada de CIM_Job.

ErrorDescription

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que contém a descrição do erro do fornecedor. Essa propriedade é herdada de CIM_Job.

ErrorSummaryDescription

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: ModelCorrespondence ("CIM_Job. ErrorCode")

Uma descrição resumida do erro, se presente. Essa propriedade é herdada de CIM_Job.

HealthState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A integridade atual do elemento. Esse atributo expressa a integridade desse elemento, mas não necessariamente a de seus subcomponentes. Os valores possíveis são de 0 a 30, em que 5 significa que o elemento está totalmente íntegro e 30 significa que o elemento é completamente não funcional. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como 5.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data e a hora em que a configuração da máquina virtual foi criada. Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como Null.

JobRunTimes

Tipo de dados: uint32
Tipo de acesso: Somente leitura

O número de vezes que o trabalho deve ser executado. Um valor 1 indica que o trabalho não é recorrente, enquanto qualquer valor diferente de zero indica um limite para o número de vezes que o trabalho será repetido. Zero indica que não há limite para o número de vezes que o trabalho pode ser processado, mas ele será encerrado depois que UntilTime for atingido ou o trabalho for encerrado manualmente. Essa propriedade é herdada de CIM_Job.

JobState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

JobState é uma enumeração de inteiro que indica o estado operacional de um trabalho. Também pode indicar transições entre esses estados, por exemplo, "Desligando" e "Iniciando". Essa propriedade é herdada de CIM_ConcreteJob.

Valor	Significado
Novo 2	O trabalho nunca foi iniciado.
Iniciando 3	O trabalho está mudando dos estados 2 (Novo), 5 (Suspenso) ou 11 (Serviço) para o estado 4 (Em execução).
Executando 4	O trabalho está em execução.
Suspenso 5	O trabalho é interrompido, mas pode ser reiniciado de maneira contínua.
Desligar 6	O trabalho está mudando para um estado 7 (Concluído), 8 (Encerrado) ou 9 (Morto).
Concluído 7	O trabalho foi concluído normalmente.
Terminado 8	O trabalho foi interrompido por uma solicitação de alteração de estado "Encerrar". O trabalho e todos os seus processos subjacentes são encerrados e só podem ser reiniciados como um novo trabalho. O requisito de que o trabalho seja reiniciado apenas como um novo trabalho é específico do trabalho.
Matou 9	O trabalho foi interrompido por uma solicitação de alteração de estado "Kill". Os processos subjacentes ainda podem estar em execução e uma limpo pode ser necessária para liberar recursos.
Exceção 10	O trabalho está em um estado anormal que pode ser um indicativo de uma condição de erro. O status real do trabalho pode estar disponível por meio de objetos específicos do trabalho.
Serviço 11	O trabalho está em um estado específico do fornecedor que dá suporte à descoberta ou resolução de problemas, ou ambos.
DMTF Reservado 12 32767	Reservado.
Fornecedor Reservado 32768 65535	Reservado.

JobStatus

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que representa o trabalho status. Essa propriedade é herdada de CIM_Job.

JobType

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica o tipo de trabalho que está sendo rastreado por esse objeto.

Desconhecido (0)

Definir Máquina Virtual (1)

Modificar Máquina Virtual (2)

Destruir máquina virtual (3)

Modificar configurações do serviço de gerenciamento (4)

Inicializar Máquina Virtual (10)

Aguardando para iniciar a máquina virtual (11)

Iniciar Máquina Virtual (12)

Desligar Máquina Virtual (13)

Salvar Máquina Virtual (14)

Restaurar Máquina Virtual (15)

Desligar máquina virtual (16)

Pausar Máquina Virtual (26)

Retomar Máquina Virtual (27)

Redefinir Máquina Virtual (28)

Reinicializar Máquina Virtual (29)

Adicionar recursos de máquina virtual (30)

Modificar recursos de máquina virtual (31)

Remover recursos de máquina virtual (32)

Solicitar memória inicial da máquina virtual (40)

Adicionar memória à máquina virtual (41)

Remover memória da máquina virtual (42)

Mesclando discos VHD (50)

Criar instantâneo do VSS dentro da Máquina Virtual (51)

Obter dados de configuração de importação (60)

Importar Máquina Virtual (61)

Exportar Máquina Virtual (62)

Configuração de Registro (63)

Configuração de cancelamento do registro (64)

Máquina Virtual de Instantâneo (70)

Aplicar instantâneo de máquina virtual (71)

Excluir Instantâneo da Máquina Virtual (72)

Limpar o estado do instantâneo da máquina virtual (73)

Adicionar recursos ao pool de recursos (80)

Remover recursos do pool de recursos (81)

Modificar configurações do servidor de replicação (90)

Criar relação de replicação (91)

Modificar configurações de relação de replicação (92)

Remover Relação de Replicação (93)

Iniciar a replicação inicial da banda (94)

Importar Replicação (95)

Replicar alteração de estado (96)

Iniciar Failover (97)

Reverter failover (98)

Failover de Confirmação (99)

Inicialização da Replicação Sincronizada (100)

Cancelar Replicação Sincronizada (101)

Iniciar Réplica de Teste (102)

Remover Réplica de Teste (103)

Replicação reversa (104)

Delta de envio de replicação (105)

Delta de Recebimento de Replicação (106)

Ressincronização (107)

Aplicar log de alterações (108)

Parar Replicação Inicial (109)

Parar a ressincronização (110)

Obter estatísticas de réplica (111)

Preparar-se para o Verificador de Consistência (112)

Verificador de Consistência (113)

Interrompa o verificador de consistência (114)

Testar conexão de replicação (115)

Enviando réplica inicial (116)

Iniciar Replicação Inicial Ressincronização (117)

Iniciar Exportar Replicação Inicial (118)

Redefinir Estatísticas de Réplica (119)

Aplicar Deltas Registrados (120)

Ressincronizando a Replicação Estendida (121)

Configuração da Réplica de Teste de Leitura (122)

Alterar o modo de replicação para primário (123)

Iniciar Failback (124)

Atualizar Conjunto de Discos (125)

Observação

Valor adicionado em Windows 10.

Definir comutador Ethernet (130)

Modificar configurações do comutador Ethernet (131)

Destruir comutador Ethernet (132)

Adicionar recursos de comutador Ethernet (133)

Modificar recursos de comutador Ethernet (134)

Remover recursos do comutador Ethernet (135)

Validar Máquina Virtual Planejada (140)

Realizando máquina virtual (141)

Criando um pool de recursos (150)

Alterando os recursos pai de um pool de recursos (151)

Alterando as configurações de não alloction de um pool de recursos (152)

Excluindo um pool de recursos (153)

Habilitar GPU RemoteFx (160)

Desabilitar GPU RemoteFx (161)

Modificar configurações de serviço 3D (162)

Observação

Valor adicionado em Windows 10.

Máquina Virtual de Backup (170)

Interface de serviço convidado (180)

Observação

Valor adicionado em Windows 10.

Informações do cluster convidado de consulta (181)

Observação

Valor adicionado em Windows 10.

Definir Coleção (190)

Observação

Valor adicionado em Windows 10.

Coleção Destroy (191)

Observação

Valor adicionado em Windows 10.

Coleção Rename (192)

Observação

Valor adicionado em Windows 10.

Adicionar membro à coleção (193)

Observação

Valor adicionado em Windows 10.

Remover Membro da Coleção (194)

Observação

Valor adicionado em Windows 10.

Adicionar Configuração à Coleção (195)

Observação

Valor adicionado em Windows 10.

Remover Configuração da Coleção (196)

Observação

Valor adicionado em Windows 10.

Modificar configuração na coleção (197)

Observação

Valor adicionado em Windows 10.

Coleção snapshot (198)

Observação

Valor adicionado em Windows 10.

Converter instantâneo em ponto de referência (200)

Observação

Valor adicionado em Windows 10.

Criar ponto de referência (201)

Observação

Valor adicionado em Windows 10.

Excluir Ponto de Referência (202)

Observação

Valor adicionado em Windows 10.

Ponto de referência de exportação (203)

Observação

Valor adicionado em Windows 10.

Remover dados associados do ponto de referência (204)

Observação

Valor adicionado em Windows 10.

Criar ponto de referência na coleção (205)

Observação

Valor adicionado em Windows 10.

Exportar ponto de referência na coleção (206)

Observação

Valor adicionado em Windows 10.

Remover dados associados do ponto de referência na coleção (207)

Observação

Valor adicionado em Windows 10.

Excluir ponto de referência na coleção (208)

Observação

Valor adicionado em Windows 10.

Importar metadados de ponto de referência (209)

Observação

Valor adicionado em Windows 10 como Ponto de Referência de Limpeza.

Montar ou desmontar dispositivo atribuível (260)

Observação

Valor adicionado em Windows 10.

LocalOrUtcTime

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica se os horários representados nas propriedades RunStartInterval e UntilTime representam horários locais ou horários UTC. Essa propriedade é herdada de CIM_Job.

Hora Local (1)
Hora UTC (2 )

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Key, MaxLen ( 256 )

O nome de exibição dessa instância de um trabalho. Além disso, o nome de exibição pode ser usado como uma propriedade para uma pesquisa ou consulta. Essa propriedade é herdada de CIM_ManagedSystemElement.

Notificar

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O usuário que é notificado após a conclusão ou falha do trabalho. Essa propriedade é herdada de CIM_Job.

OperatingStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status atuais para a condição operacional do elemento e pode ser usado para fornecer mais detalhes em relação ao valor da propriedade EnabledState. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

OperationalStatus

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Os status atuais do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como 2 (OK).

OtherRecoveryAction

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve a ação de recuperação quando a propriedade RecoveryAction da instância é 1 (Outros). Essa propriedade é herdada de CIM_Job.

Proprietário

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O usuário que enviou o trabalho. Essa propriedade é herdada de CIM_Job.

PercentComplete

Tipo de dados: uint16
Tipo de acesso: Somente leitura
Qualificadores: MinValue ( 0 ), MaxValue ( 100 ), Unidades ( "Porcentagem" )

O percentual de conclusão do trabalho. Essa propriedade é herdada de CIM_Job.

PrimaryStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status de alto nível. Essa propriedade deve ser usada em conjunto com a propriedade DetailedStatus para fornecer status de integridade detalhadas e de alto nível do elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Prioridade

Tipo de dados: uint32
Tipo de acesso: Somente leitura

A importância da execução de um trabalho. Essa propriedade é herdada de CIM_Job.

RecoveryAction

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Descreve a ação de recuperação a ser executada para um trabalho que não foi executado com êxito. Essa propriedade é herdada de CIM_Job.

Desconhecido (0)
Outros (1)
Não Continuar (2)
Continuar com o próximo trabalho (3)
Executar novamente o trabalho (4)
Executar trabalho de recuperação (5 )

RunDay

Tipo de dados: sint8
Tipo de acesso: Somente leitura
Qualificadores: MinValue ( -31 ), MaxValue ( 31 )

O dia do mês em que o trabalho deve ser processado. Há interpretações diferentes para essa propriedade, dependendo do valor de RunDayOfWeek.

Quando RunDayOfWeek é 0 e RunDay é positivo, RunDay define o dia do mês em que o trabalho é processado. Por exemplo, se RunDayOfWeek for 0 e RunDay for 12, o trabalho será processado no^12º dia do mês.

Quando RunDayOfWeek é 0 e RunDay é negativo, RunDay define o número de dias antes do último dia do mês em que o trabalho é processado. 1 indica o último dia do mês, 2 indica um dia antes do último dia do mês e assim por diante. Por exemplo, se RunDayOfWeek for 0 e RunDay for 1, o trabalho será processado no último dia do mês.

Quando RunDayOfWeek não é 0, RunDayOfWeek é o dia da semana em que o trabalho será processado, em relação ao RunDay. Por exemplo, se RunDay for 15 e RunDayOfWeek for 7 (+sábado), o trabalho será processado no primeiro sábado no dia^{15 do} mês ou após o dia 15. Se RunDay for 20 e RunDayOfWeek for 7 ( sábado), o trabalho será processado no primeiro sábado no dia 20 ou antes do^20º dia do mês. Se RunDay for 1 e RunDayOfWeek for 1 ( domingo), o trabalho será processado no último domingo do mês.

Essa propriedade é herdada de CIM_Job.

RunDayOfWeek

Tipo de dados: sint8
Tipo de acesso: Somente leitura

Um inteiro positivo ou negativo usado em conjunto com o RunDay para indicar o dia da semana ou mês em que o trabalho é processado. Confira a descrição da propriedade RunDay para obter mais informações. Essa propriedade é herdada de CIM_Job.

-Sábado ( 7)
-Friday ( 6)
-Quinta-feira ( 5)
-Quarta-feira ( 4)
-Terça-feira ( 3)
-Segunda-feira ( 2)
-Sunday ( 1)
ExactDayOfMonth (0)
Domingo (1)
Segunda-feira (2)
Terça-feira (3)
Quarta-feira (4)
Quinta-feira (5)
Sexta-feira (6)
Sábado (7 )

RunMonth

Tipo de dados: uint8
Tipo de acesso: Somente leitura

O mês durante o qual o trabalho deve ser processado. Essa propriedade é herdada de CIM_Job.

Janeiro (0)
Fevereiro (1)
Março (2)
Abril (3)
Maio (4)
Junho (5)
Julho (6)
Agosto (7)
Setembro (8)
Outubro (9)
Novembro (10)
Dezembro (11 )

RunStartInterval

Tipo de dados: datetime
Tipo de acesso: Somente leitura

O intervalo de tempo após a meia-noite em que o trabalho deve ser processado. Essa propriedade é herdada de CIM_Job.

ScheduledStartTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A hora de início agendada para o trabalho, se aplicável. Essa propriedade é herdada de CIM_Job.

StartTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A hora em que o trabalho começou. Essa propriedade é herdada de CIM_Job.

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_ManagedSystemElement, mas não é usada.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus . Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como "OK".

TimeBeforeRemoval

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A quantidade de tempo, em minutos, que o trabalho é mantido após a conclusão da execução, seja com êxito ou falha nessa execução. O trabalho deve permanecer existente por algum período de tempo, independentemente do valor da propriedade DeleteOnCompletion . O padrão é de cinco minutos. Essa propriedade é herdada de CIM_ConcreteJob e é sempre definida como 00000000000500.000000:000.

TimeOfLastStateChange

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data ou hora em que o estado do trabalho foi alterado pela última vez. Se o estado do trabalho não tiver sido alterado e essa propriedade for populada, ela deverá ser definida como um valor de intervalo de 0. Se uma alteração de estado foi solicitada, mas rejeitada ou ainda não processada, a propriedade não deve ser atualizada. Essa propriedade é herdada de CIM_ConcreteJob.

TimeSubmitted

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A hora em que o trabalho foi enviado. Essa propriedade é herdada de CIM_Job.

UntilTime

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A hora em que o trabalho não é válido ou deve ser interrompido. Essa propriedade é herdada de CIM_Job.

Comentários

O acesso à classe Msvm_ConcreteJob pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de conta de usuário e WMI.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

CIM_ConcreteJob
CIM_ConcreteJob
Classes de gerenciamento de sistema virtual

Partilhar via

classe Msvm_ConcreteJob

Sintaxe

Membros

Métodos

Propriedades

Comentários

Requisitos

Confira também

Comentários

Recursos adicionais