classe Msvm_ConcreteJob

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 é um código MOF (Formato de Objeto Gerenciado) 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 esses tipos de membros:

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 terá êxito.

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 nulo indica que essa propriedade não foi 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 de status adicionais. Um valor nulo indica que essa propriedade não foi 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 estiver 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 deve 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 de 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 é 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 o 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. Ele 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á migrando 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 perfeita.
Desligar
6
O trabalho está sendo movido para um estado 7 (Concluído), 8 (Encerrado) ou 9 (Morto).
Concluído
7
O trabalho foi concluído normalmente.
Terminada
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 limpeza 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 de problemas, resolução 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 status do trabalho. 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 da 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 da 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 de inband (94)

Importar Replicação (95)

Replicar alteração de estado (96)

Iniciar failover (97)

Reverter failover (98)

Failover de confirmação (99)

Inititate Synced Replication (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)

Interromper replicação inicial (109)

Parar a ressincronização (110)

Obter estatísticas de réplica (111)

Preparar 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 Ressíncrona (117)

Iniciar a exportação de replicação inicial (118)

Redefinir estatísticas de réplica (119)

Aplicar Deltas Registrados (120)

Ressincronizando a Replicação Estendida (121)

Configuração de 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 o comutador Ethernet (130)

Modificar o comutador Ethernet Configurações (131)

Destrua o 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 o Configurações de não alusão de um pool de recursos (152)

Excluindo um pool de recursos (153)

Habilitar a GPU RemoteFx (160)

Desabilitar a GPU RemoteFx (161)

Modificar Configurações de Serviço 3D (162)

Observação

Valor adicionado em Windows 10.

Backup Máquina Virtual (170)

Interface do 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 do 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 nulo indica que essa propriedade não foi 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 detalhado e de alto nível do elemento e seus subcomponentes. Um valor nulo indica que essa propriedade não foi 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, o 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 ou após o 15º dia do mês. Se RunDay for 20 e RunDayOfWeek for 7 ( sábado), o trabalho será processado no primeiro sábado no dia 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. Consulte a descrição da propriedade RunDay para obter mais informações. Essa propriedade é herdada de CIM_Job.

-Sábado ( 7)

-Sexta-feira ( 6)

-Quinta-feira ( 5)

-Quarta-feira ( 4)

-Terça-feira ( 3)

-Segunda-feira ( 2)

-Domingo ( 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, de que o trabalho é retido 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.0000000: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 preenchida, 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

O momento 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