Classe Msvm_DiskDrive

Representa uma unidade de disco rígido dentro de uma máquina virtual. Essa unidade de disco rígido pode ser um dispositivo de passagem (se um disco rígido físico foi anexado à máquina virtual) ou um dispositivo sintético que é preenchido com mídia de disco rígido virtual. Como discos rígidos virtuais e físicos podem ser adicionados e removidos da máquina virtual, há dois pools de recursos associados a essa classe, um para discos rígidos de passagem e outro para discos rígidos virtuais. Discos rígidos só podem ser adicionados ou removidos do controlador SCSI virtual quando a máquina virtual está online. Os discos só podem ser adicionados ou removidos do controlador de IDE virtual quando a máquina virtual está offline.

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_DiskDrive : CIM_DiskDrive
{
  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;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

Membros

A classe Msvm_DiskDrive tem estes tipos de membros:

Métodos

A classe Msvm_DiskDrive tem esses métodos.

Método Descrição
EnableDevice Não há suporte para o método.
LockMedia Bloqueia ou libera a mídia.
OnlineDevice Não há suporte para o método.
QuiesceDevice Não há suporte para o método.
RequestStateChange Solicita uma alteração de estado.
Redefinir Redefine o dispositivo virtual.
RestoreProperties Não há suporte para o método.
SaveProperties Não há suporte para o método.
SetPowerState Não há suporte para o método.

Propriedades

A classe Msvm_DiskDrive tem essas propriedades.

AdditionalAvailability

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_LogicalDevice e está definida como 6 (Não Aplicável).

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_LogicalDevice.

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.

Funcionalidades

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Os recursos do dispositivo de acesso à mídia. Essa propriedade é herdada de CIM_MediaAccessDevice e é definida com os valores a seguir.

Valor Significado
3
A entrada correspondente em CapabilityDescriptions é "Acesso Aleatório".
4
A entrada correspondente em CapabilityDescriptions é "Suporte à gravação".

CapabilityDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornece explicações detalhadas para acessar recursos de dispositivo indicados na matriz de propriedades Capabilities . Cada entrada dessa matriz está relacionada à entrada na matriz de propriedades Capabilities , localizada no mesmo índice. Essa propriedade é herdada de CIM_MediaAccessDevice.

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.

Desconhecido (0)

Não disponível (1)

Comunicação OK (2)

Comunicação Perdida (3)

Sem Contato (4)

DMTF Reservado (..)

Fornecedor Reservado (0x8000.. )

CompressionMethod

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que indica o algoritmo ou a ferramenta usada para compactar o arquivo lógico. Se o esquema de compactação for desconhecido ou não descrito, use "Desconhecido". Se o arquivo lógico for compactado, mas o esquema de compactação for desconhecido ou não descrito, use "Compactado". Se o arquivo lógico não for compactado, use "Não compactado". Essa propriedade é herdada de CIM_MediaAccessDevice e é definida como "Não Compactada".

CreationClassName

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O nome da classe ou subclasse usada na criação de uma instância. Essa propriedade é herdada de CIM_LogicalDevice.

DefaultBlockSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tamanho do bloco padrão, em bytes, para o dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 512.

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.

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

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um endereço ou outras informações de identificação para nomear exclusivamente o dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice.

DriveNumber

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O número de unidades físicas no sistema de computador de hospedagem.

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.

EnabledDefault

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A configuração padrão ou de inicialização de um administrador para o estado habilitado de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement.

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Os estados habilitados e desabilitados de um elemento. Ele também pode indicar as transições entre esses estados solicitados. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor Significado
Desconhecido
0
Não foi possível determinar o estado do elemento.
Outros
1
Enabled
2
O elemento está em execução.
Desabilitado
3
O elemento está desativado.
Desligar
4
O elemento está no processo de ir para um estado Desabilitado.
Não aplicável
5
O elemento não dá suporte a ser habilitado ou desabilitado.
Habilitado, mas Offline
6
O elemento pode estar concluindo comandos e removerá quaisquer novas solicitações.
Em teste
7
O elemento está em um estado de teste.
Adiada
8
O elemento pode estar concluindo comandos, mas enfileirará quaisquer novas solicitações.
Fechar
9
O elemento está habilitado, mas está em um modo restrito. O comportamento do elemento é semelhante ao estado Enabled (2), mas processa apenas um conjunto restrito de comandos. Todas as outras solicitações são enfileiradas.
Iniciando
10
O elemento está no processo de ir para um estado Enabled (2). Novas solicitações são enfileiradas.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

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

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

ErrorMethodology

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve os tipos de detecção e correção de erros compatíveis com esse dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como "Nenhum".

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.

IdentifyingDescriptions

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_LogicalDevice e está definida como Null.

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.

LastCleaned

Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data e a hora em que o dispositivo foi limpo pela última vez. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como Null.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

LoadTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tempo, em milissegundos, desde a carga até a capacidade de ler ou gravar uma mídia. Por exemplo, para unidades de disco, esse é o intervalo entre um disco que não gira para o relatório de disco que ele está pronto para leitura/gravação (ou seja, o disco girando em velocidades nominais). Para unidades de fita, esse é o momento de uma mídia ser injetada para relatar que está pronta para um aplicativo. Isso geralmente está na área de BOT da fita. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

MaxAccessTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tempo, em milissegundos, para passar do primeiro local na mídia para o local mais distante em relação ao tempo. Para uma unidade de disco, isso representa a busca completa e o atraso de rotação total. Para unidades de fita, isso representa uma pesquisa desde o início da fita até o ponto mais fisicamente distante. (O final de uma fita pode estar em seu ponto mais fisicamente distante, mas isso não é necessariamente verdadeiro.) Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

MaxBlockSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tamanho máximo do bloco, em bytes, para mídia acessada pelo dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice e é definida como 512 para unidades de disco rígido virtual, variável para unidades de passagem.

MaxMediaSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tamanho máximo, em quilobytes, da mídia compatível com este dispositivo. Os quilobytes são interpretados como o número de bytes multiplicado por 1000 (não o número de bytes multiplicado por 1024). Essa propriedade é herdada de CIM_MediaAccessDevice e é definida como 2.000.000.000 para unidades de disco rígido virtual, variável para unidades de passagem.

MaxQuiesceTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

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

MaxUnitsBeforeCleaning

Tipo de dados: uint64

Tipo de acesso: Somente leitura

As unidades máximas que podem ser usadas antes que o dispositivo seja limpo. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0xffffffffffffffff.

MediaIsLocked

Tipo de dados: booliano

Tipo de acesso: Somente leitura

True se a mídia estiver bloqueada no dispositivo e não puder ser ejetada; caso contrário, False. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como True.

MinBlockSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tamanho mínimo do bloco, em bytes, para mídia acessada pelo dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 512.

MountCount

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte a mídia removível, o número de vezes que a mídia foi montada para transferência de dados ou para limpo o dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não é aplicável e deve ser definida como 0. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

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.

NeedsCleaning

Tipo de dados: booliano

Tipo de acesso: Somente leitura

True se o dispositivo de acesso à mídia precisar de limpeza; caso contrário, False. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como False.

NumberOfMediaSupported

Tipo de dados: uint32

Tipo de acesso: Somente leitura

O número máximo de várias mídias individuais que podem ser suportadas ou inseridas. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 1.

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)

Emigrou (10)

Immigrating (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

Os status atuais do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

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.

OtherIdentifyingInfo

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_LogicalDevice e está definida como Null.

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

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

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

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

PowerOnHours

Tipo de dados: uint64

Tipo de acesso: Somente leitura

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

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.

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 do CIM_EnabledLogicalElement pode não dar suporte ao método RequestStateChange . Se isso ocorrer, o valor 12 (Não Aplicável) será usado. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Segurança

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A segurança operacional definida para o dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice e é definida como 3 (Nenhum).

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.

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

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

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

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O identificador exclusivo para a máquina virtual de escopo. Essa propriedade é herdada de CIM_LogicalDevice.

TimeOfLastMount

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte à mídia removível, a data e hora mais recentes em que a mídia foi montada no dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não tem significado e não é aplicável. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como Null.

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 e é sempre definida como "NULL".

TotalMountTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte à mídia removível, o tempo total (em segundos) que a mídia foi montada para transferência de dados ou para limpo o dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não é aplicável e deve ser definida como 0. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

TotalPowerOnHours

Tipo de dados: uint64

Tipo de acesso: Somente leitura

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

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.

UncompressedDataRate

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A taxa de transferência de dados sustentada em KB/s da qual o dispositivo pode ler e gravar em uma mídia. Essa é uma taxa de dados bruta e sustentada. Taxas ou taxas máximas supondo que a compactação não deve ser relatada nesta propriedade. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como Null.

UnitsDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

As unidades relativas ao seu uso em MaxUnitsBeforeCleaning. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como Null.

UnitsUsed

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O número atual de unidades usadas. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

UnloadTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O tempo, em milissegundos, de ser capaz de ler ou gravar uma mídia em seu descarregamento. Essa propriedade é herdada de CIM_MediaAccessDevice e está definida como 0.

Comentários

O acesso à classe Msvm_DiskDrive 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_DiskDrive

CIM_DiskDrive

Classes de armazenamento