Compartilhar via

classe Msvm_MigrationJob

  • Artigo

Essa classe representa um trabalho de operação de migração criado para armazenamento ou migração de sistema virtual pelo serviço de migração do sistema virtual.

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_MigrationJob : 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;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 00000000000500.000000:000;
  boolean  Cancellable;
  string   ErrorSummaryDescription;
  uint16   MigrationType;
  string   VirtualSystemName;
  string   DestinationHost;
  string   NewSystemSettingData;
  string   NewResourceSettingData[];
  uint16   JobType;
};

Membros

A classe Msvm_MigrationJob tem estes tipos de membros:

Métodos

A classe Msvm_MigrationJob tem esses métodos.

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

Propriedades

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

DestinationHost

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do host da plataforma de virtualização de destino para a qual o sistema virtual está migrando. Isso será Null para migração de armazenamento.

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 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.

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á 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 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)

Criando máquina virtual remota (300)

Verificando a compatibilidade da máquina virtual (301)

Verificando a compatibilidade de máquina virtual e armazenamento (302)

Verificando a compatibilidade de armazenamento (303)

Verificando a migração de armazenamento (304)

Movendo máquina virtual (305)

Movendo a Máquina Virtual e o Armazenamento (306)

Movendo o armazenamento (307)

LocalOrUtcTime

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_Job.

Indica se os horários representados nas propriedades RunStartInterval e UntilTime representam horários locais ou horários UTC.

Hora Local (1)

Hora UTC (2 )

MigrationType

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("Msvm_VirtualSystemMigrationSettingData. MigrationType")

O tipo de migração representado por esse objeto de trabalho. Esse será um dos valores definidos para a propriedade MigrationType da classe Msvm_VirtualSystemMigrationSettingData .

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Key, MaxLen ( 256 )

O nome de exibição para esta 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.

NewResourceSettingData

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Para uma migração dinâmica, isso sempre será definido como Null.

Para uma migração de armazenamento, se for Null, nenhum dos VHDs (discos rígidos virtuais) da máquina virtual será movido. Caso contrário, isso conterá uma matriz de instâncias inseridas da classe Msvm_StorageAllocationSettingData que representam os VHDs a serem movidos. A propriedade Connection dessas instâncias especificará o local de destino do VHD.

NewSystemSettingData

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Para uma migração dinâmica, isso sempre será definido como Null.

Para uma migração de armazenamento, se for Null, as raízes de dados da máquina virtual não serão movidas. Caso contrário, isso conterá uma instância inserida da classe Msvm_VirtualSystemSettingData , em que as propriedades ExternalDataRoot, SnapshotDataRoot e SwapFileDataRoot especificarão as novas raízes de dados.

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 executado sem ê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

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.

VirtualSystemName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome exclusivo do sistema virtual afetado.

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