Classe Msvm_ImageManagementService
Gerencia a mídia virtual (arquivos .vhd, .vhdx, .iso ou .vfd) para uma máquina 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_ImageManagementService : CIM_Service
{
string InstanceID;
string Caption = "Hyper-V Image Management Service";
string Description = "Provides Image Management servicing for Hyper-V";
string ElementName = "Hyper-V Image Management Service";
datetime InstallDate;
uint16 OperationalStatus[] = { 2 };
string StatusDescriptions[] = { "OK" };
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState = 2;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_ImageManagementService";
string Name = "vhdsvc";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
Membros
A classe Msvm_ImageManagementService tem estes tipos de membros:
Métodos
A classe Msvm_ImageManagementService tem esses métodos.
| Método | Descrição |
|---|---|
| AttachVirtualHardDisk | Anexa um arquivo de imagem de disco virtual no modo loopback. |
| CompactVirtualHardDisk | Compacta um arquivo de disco rígido virtual. |
| ConvertVirtualHardDisk | Converte um disco rígido virtual existente em um tipo ou formato diferente. |
| ConvertVirtualHardDiskToVHDSet | Converte um arquivo de disco rígido virtual criando um novo arquivo de conjunto de VHD junto com o disco rígido virtual existente. |
| CreateVirtualFloppyDisk | Cria um arquivo de disquete virtual. |
| CreateVirtualHardDisk | Cria um arquivo de disco rígido virtual. |
| DeleteVHDSnapshot | Exclui uma entrada de instantâneo VHD dentro de um arquivo de conjunto de VHD. |
| FindMountedStorageImageInstance | Localiza um objeto Msvm_MountedStorageImage para um determinado caminho de imagem de disco. |
| GetVHDSetInformation | Recupera informações sobre um arquivo de conjunto de VHD. |
| GetVHDSnapshotInformation | Recupera informações sobre um instantâneo VHD em um arquivo de conjunto de VHD. |
| GetVirtualDiskChanges | Recupera uma lista de alterações na região especificada de um disco virtual desde a ID de Controle de Alterações resiliente fornecida ou a ID de instantâneo do VHDSet fornecida. |
| GetVirtualHardDiskSettingData | Recupera os dados de configuração associados a arquivos de disco rígido virtual. |
| GetVirtualHardDiskState | Recupera o estado dos arquivos de disco rígido virtual. |
| MergeVirtualHardDisk | Mescla um disco rígido virtual filho em uma cadeia de diferenciação com um ou mais discos rígidos virtuais pai na cadeia. |
| OptimizeVHDSet | Otimiza um arquivo de conjunto de VHD para usar menos espaço em disco. |
| RequestStateChange | Solicita uma alteração de estado. |
| ResizeVirtualHardDisk | Redimensiona um disco rígido virtual existente. |
| SetParentVirtualHardDisk | Atualizações o pai para os arquivos de disco rígido virtual filho e folha especificados. |
| SetVHDSnapshotInformation | Edita uma entrada de instantâneo VHD em um arquivo de conjunto de VHD. Se a ID do instantâneo em questão já existir, a entrada de Instantâneo existente será substituída pela nova entrada. Caso contrário, a nova entrada será adicionada ao arquivo VHD Set. |
| SetVirtualHardDiskSettingData | Define um arquivo de disco rígido virtual. |
| Startservice | Inicia o serviço. |
| StopService | Interrompe o serviço. |
| ValidatePersistentReservationSupport | Valida se um sistema de arquivos pode dar suporte a um disco rígido virtual com reservas persistentes habilitadas. |
| ValidateVirtualHardDisk | Valida se uma imagem de disco virtual pode ser aberta no modo somente leitura. |
Propriedades
A classe Msvm_ImageManagementService tem essas propriedades.
-
AvailableRequestedStates
-
-
Tipo de dados: matriz uint16
-
Tipo de acesso: Somente leitura
Indica os valores possíveis para o parâmetro RequestedState do método RequestStateChange . Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como Null.
-
-
Legenda
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Serviço de Gerenciamento de Imagens do Hyper-V".
-
-
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.
-
Desconhecido (0)
-
Não disponível (1)
-
Comunicação OK (2)
-
Comunicação Perdida (3)
-
Sem Contato (4)
-
DMTF Reservado (..)
-
Fornecedor Reservado (0x8000.. )
-
-
CreationClassName
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O nome da classe ou subclasse usada na criação de uma instância. Essa propriedade é herdada de CIM_Service e é sempre definida como "Msvm_ImageManagementService".
-
-
Descrição
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement e é sempre definida como "Fornece serviço de Gerenciamento de Imagens para Hyper-V".
-
-
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.
-
Não disponível (0)
-
Nenhuma informação adicional (1)
-
Estressado (2)
-
Falha preditiva (3)
-
Erro não recuperável (4)
-
Entidade de suporte em erro (5)
-
DMTF Reservado (..)
-
Fornecedor Reservado (0x8000.. )
-
-
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 e é sempre definida como "Serviço de Gerenciamento de Imagens do Hyper-V".
-
-
EnabledDefault
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Configuração padrão ou de inicialização de um administrador para o estado habilitado de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 2 (Habilitado).
-
-
EnabledState
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Os estados habilitados e desabilitados de um elemento. Também pode indicar as transições entre esses estados solicitados. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como 2 (Habilitado).
-
-
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.
-
-
Nome
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Chave, Substituição ("Nome"), MaxLen (256)
O rótulo pelo qual o objeto é conhecido. Essa propriedade é herdada de CIM_Service e é sempre definida como "vhdsvc".
-
-
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.
-
Desconhecido (0)
-
Não disponível (1)
-
Manutenção (2)
-
Começando (3)
-
Parando (4)
-
Parado (5)
-
Anulado (6)
-
Dormente (7)
-
Concluído (8)
-
Migrando (9)
-
Emigrando (10)
-
Imigração (11)
-
Instantâneo (12)
-
Desligar (13)
-
Em Teste (14)
-
Transição (15)
-
Em Serviço (16)
-
DMTF Reservado (..)
-
Fornecedor Reservado (0x8000.. )
-
-
OperationalStatus
-
-
Tipo de dados: matriz uint16
-
Tipo de acesso: Somente leitura
O status atual do objeto . Essa propriedade é herdada de CIM_ManagedSystemElement e cada elemento de matriz é sempre definido como 2 (OK).
-
-
OtherEnabledState
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1 (Outros). Essa propriedade deve ser definida como Null quando EnabledState for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EnabledLogicalElement e sempre é definida como Null.
-
-
PrimaryOwnerContact
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Uma cadeia de caracteres que fornece informações sobre como o proprietário primário do serviço pode ser acessado (por exemplo, número de telefone, endereço de email e assim por diante). Essa propriedade é herdada de CIM_Service e é sempre definida como Null.
-
-
PrimaryOwnerName
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O nome do proprietário primário do serviço, se um for definido. O proprietário primário é o contato de suporte inicial para o serviço. Essa propriedade é herdada de CIM_Service e é sempre definida como Null.
-
-
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 detalhada 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.
-
Desconhecido (0)
-
OK (1)
-
Degradado (2)
-
Erro (3)
-
DMTF Reservado (..)
-
Fornecedor Reservado (0x8000.. )
-
-
RequestedState
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
O último estado solicitado ou desejado para o elemento . O estado real do elemento é representado por EnabledState. Essa propriedade é fornecida para comparar os últimos estados solicitados e atuais habilitados ou desabilitados. Uma instância específica de EnabledLogicalElement pode não dar suporte a RequestedStateChange. Se isso ocorrer, o valor 12 (Não Aplicável) será usado. Essa propriedade é herdada de CIM_EnabledLogicalElement e sempre é definida como 12 (Não Aplicável).
-
-
Iniciado
-
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Indica se o serviço foi iniciado. Essa propriedade é herdada de CIM_Service e é sempre definida como True.
-
-
StartMode
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Um valor de cadeia de caracteres que indica se o serviço é iniciado automaticamente por um sistema, um sistema operacional ou é iniciado somente após a solicitação. Essa propriedade é herdada de CIM_Service e é sempre definida como Null.
-
-
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.
-
-
SystemCreationClassName
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O nome da classe de criação do sistema de escopo. Essa propriedade é herdada de CIM_Service e é sempre definida como "Msvm_ComputerSystem".
-
-
Systemname
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O nome do sistema de computador de hospedagem. Essa propriedade é herdada de CIM_Service.
-
-
TimeOfLastStateChange
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
A data ou hora em que o estado habilitado do elemento foi alterado pela última vez. Essa propriedade é herdada de CIM_EnabledLogicalElement.
-
-
TransitioningToState
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Indica o estado de destino para o qual a instância está em transição. Essa propriedade é herdada de CIM_EnabledLogicalElement e sempre é definida como Null.
-
Comentários
O acesso à classe Msvm_ImageManagementService 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 |
|
| DLL |
|