Compartilhar via

classe Msvm_StorageJob

  • Artigo

Representa um trabalho de operação de armazenamento criado pelo Microsoft Hyper-V Image Management Service.

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

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  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;
  string   Child;
  UINT32   JobCompletionStatusCode;
  string   Parent;
  uint16   JobType;
};

Membros

A classe Msvm_StorageJob tem estes tipos de membros:

Métodos

A classe Msvm_StorageJob tem esses métodos.

Método Descrição
GetError Recupera o erro que descreve o motivo pelo qual o trabalho falhou.
GetErrorEx Quando o trabalho está em execução ou foi encerrado sem erro, esse método não retorna nenhuma instância Msvm_Error . No entanto, se o trabalho falhou devido a algum problema interno ou porque o trabalho foi encerrado por um cliente, uma ou mais instâncias Msvm_Error são retornadas.
KillJob Não há suporte para o método.
RequestStateChange Solicita uma alteração de estado.

Propriedades

A classe Msvm_StorageJob 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.

Criança

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Em caso de falha da operação assíncrona, essa propriedade contém o caminho completo do filho do VHD que está sendo afetado por essa operação.

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 status adicionais. 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 período de tempo em que o trabalho foi executado. 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

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement.

JobCompletionStatusCode

Tipo de dados: UINT32

Tipo de acesso: Somente leitura

O código HRESULT que descreve o status de conclusão para a operação assíncrona.

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

O estado operacional de um trabalho. Também pode indicar transições entre esses estados, por exemplo, 6 (Desligamento) e 3 (Iniciando). Essa propriedade é herdada de CIM_ConcreteJob.

Valor Significado
Novo
2
 O trabalho nunca foi iniciado.
Iniciando
3
 O trabalho está migrando dos estados "Novo", "Suspenso" ou "Serviço" para o estado "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 "Concluído", "Encerrado" ou "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

O tipo de operação assíncrona que está sendo controlada por essa instância de Msvm_StorageJob.

Desconhecido (0)

Criação de VHD (1)

Criando uma imagem de VHD (disco rígido virtual).

Criação de disquetes (2)

Criando uma VFD (imagem de disco de disquete virtual).

Compactação (3)

Compactando o tamanho de uma imagem VHD.

Expansão (4)

Expandindo o tamanho de uma imagem VHD.

Mesclagem (5)

Mesclando várias imagens VHD em uma única imagem.

Conversão (6)

Convertendo o tipo de uma imagem de disco rígido virtual.

Montagem de loopback (7)

Montar o disco rígido virtual na partição pai

Obter informações do VHD (8)

Montar o VHD no sistema operacional de gerenciamento.

Validar imagem VHD (9)

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

O rótulo pelo qual o objeto é conhecido. 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.

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.

Pai

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Em caso de falha da operação assíncrona, essa propriedade contém o caminho do arquivo para o pai do VHD que está sendo afetado por essa operação.

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 no12º 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 dia15 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 do20º 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

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.

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 hora em que o estado da máquina virtual foi modificado pela última vez. Essa propriedade é herdada de CIM_EnabledLogicalElement.

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_StorageJob 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 armazenamento