MSFT_VirtualDisk aula
Representa um volume de armazenamento do subsistema.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format).
Sintaxe
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
Membros
A classe MSFT_VirtualDisk tem estes tipos de membros:
Métodos
A classe MSFT_VirtualDisk tem esses métodos.
| Método | Descrição |
|---|---|
| AddPhysicalDisk | Adiciona um ou mais discos físicos para alocação manual. |
| Attach | Anexa o disco virtual. |
| Criar clone | Cria um novo disco virtual que é um clone do disco virtual existente. |
| CreateReplica | Cria uma relação de replicação entre discos virtuais. |
| CreateSnapshot | Cria um clone de um disco virtual, resultando em um novo disco virtual cujos dados são idênticos aos do disco virtual original. |
| DeleteObject | Exclui o disco virtual. |
| Desanexar | Desanexa o disco virtual. |
| GetSecurityDescriptor | Recupera o descritor de segurança que controla o acesso à instância do objeto de disco virtual. |
| Ocultar | Oculta o disco virtual. |
| RemovePhysicalDisk | Remove um ou mais discos físicos da alocação manual. |
| Repair | Inicia um reparo do disco virtual, restaurando dados e redundância para discos físicos diferentes (ou novos) dentro do pool de armazenamento. |
| Redimensionar | Redimensiona o disco virtual. |
| SetAttributes | Define ou atualiza vários atributos para o disco virtual. |
| SetFriendlyName | Define o nome amigável para o disco virtual. |
| SetReplicationRelationship | Define a relação de replicação entre discos virtuais. |
| SetSecurityDescriptor | Define o descritor de segurança que controla o acesso à instância do objeto de disco virtual. |
| SetUsage | Define o uso pretendido para o disco virtual. |
| Mostrar | Expõe o disco virtual. |
Propriedades
A classe MSFT_VirtualDisk tem essas propriedades.
Acesso
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Indica se o disco virtual está disponível para acesso de leitura e gravação.
Desconhecido (0)
Legível (1)
Gravável (2)
Leitura/Gravação (3)
Escreva uma vez (4)
AllocatedSize
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
Qualificadores: Obrigatórios, Unidades ("Bytes")
O tamanho atualmente alocado do disco virtual. Se o ProvisioningType do disco virtual for Fixed, AllocatedSize deverá ser igual a Size. Se o ProvisioningType for Thin, esse valor será a quantidade de espaço realmente alocado (que deve ser menor que Size).
Razão Desanexada
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
A razão pela qual este disco virtual está desanexado. Essa propriedade só será definida quando o OperationalStatus do disco virtual incluir Desanexado. Observe que esse campo é específico para espaços de armazenamento.
Desconhecido (0)
Nenhum (1)
Por política (2)
Discos majoritários não íntegros (3)
Incompleto (4)
Pegada na piscina
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
Qualificadores: Unidades ("Bytes")
A capacidade total do pool de armazenamento, em bytes, que está sendo consumida por esse disco virtual. Por exemplo, no caso de um disco virtual espelhado de 2 vias cujo tamanho é de 1 GB, o volume no pool seria de aproximadamente 2 GB.
FriendlyName
Tipo de dados: String
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
Uma cadeia de caracteres orientada a exibição configurável pelo usuário que contém o nome do disco virtual.
HealthStatus
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
O status de integridade do disco virtual.
A integridade de um disco virtual é derivada da integridade dos discos físicos de backup e se o disco virtual pode ou não manter os níveis necessários de resiliência.
| Valor | Significado |
|---|---|
| Saudável 0 | Todos os discos físicos estão presentes e em um estado íntegro. |
| Aviso 1 | A maioria dos discos físicos está íntegra, mas um ou mais podem estar falhando nas solicitações de E/S. |
| Insalubre 2 | A maioria dos discos físicos não está íntegra ou está em um estado de falha, e o disco virtual não tem mais integridade de dados. |
| Desconhecido 5 | O estado de saúde é desconhecido. |
Interleave
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
O número de bytes que formarão uma faixa em configurações comuns de resiliência baseadas em distribuição. A faixa é definida como o tamanho da parte de uma faixa que está em um disco físico. Assim, Intercalar * NumberOfColumns produzirá o tamanho de uma faixa de dados do usuário.
IsDeduplicationEnabled
Tipo de dados: booleano
Tipo de acesso: leitura/gravação
TRUE se a eliminação de duplicação de dados estiver habilitada para o disco virtual.
IsEnclosureAware
Tipo de dados: booleano
Tipo de acesso: Somente leitura
O comportamento de alocação atual para este disco virtual. Os discos virtuais com reconhecimento de gabinete escolherão de forma inteligente os discos físicos a serem usados para sua redundância. Se for TRUE, o disco virtual tentará usar discos físicos de diferentes compartimentos para equilibrar a tolerância a falhas entre dois ou mais compartimentos físicos.
IsManualAttach
Tipo de dados: booleano
Tipo de acesso: leitura/gravação
TRUE se esse disco virtual só será anexado ao sistema se uma chamada explícita for feita para o método Attach. Observe que essa propriedade é específica para espaços de armazenamento.
IsSnapshot
Tipo de dados: booleano
Tipo de acesso: Somente leitura
TRUE se esse disco virtual for uma cópia de sombra de outro disco virtual.
LogicalSectorSize
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
Qualificadores: Unidades ("Bytes")
O tamanho do setor lógico do disco virtual, em bytes.
Nome
Tipo de dados: string
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
Uma cadeia de caracteres legível semi-exclusiva (com escopo para o subsistema de armazenamento proprietário) que é usada para identificar o disco virtual.
Formato de nome
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
O formato da propriedade Name .
Desconhecido (0)
Outros (1)
VPD83NAA6 (2)
VPD83NAA5 (3)
VPD83Tipo2 (4)
VPD83Tipo1 (5)
VPD83Tipo0 (6)
SNVM (7)
NodeWWN (8)
AAN (9)
EUI64 (10)
T10VID (11)
Número de cópias disponíveis
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
O número de cópias consistentes de dados disponíveis.
Número de colunas
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
O número de discos físicos subjacentes nos quais os dados desse disco virtual são distribuídos.
Número de cópias de dados
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
O número de cópias de dados completas que estão sendo mantidas para o disco virtual. Por exemplo, o RAID 5 mantém uma cópia dos dados, enquanto o RAID 1 mantém pelo menos duas cópias.
OperationalStatus
Tipo de dados: matriz UInt16
Tipo de acesso: Somente leitura
Uma matriz de valores que indicam as condições operacionais atuais do disco virtual. Ao contrário de HealthStatus, essa propriedade indica o status de problemas de hardware, software e infraestrutura relacionados a esse disco virtual e pode conter vários valores.
| Valor | Significado |
|---|---|
| Desconhecido 0 | O status operacional é desconhecido. |
| Outros 1 | Um OperationalStatus específico do fornecedor foi especificado definindo a propriedade OtherOperationalStatusDescription. |
| OK 2 | O disco virtual está respondendo a comandos e está em um estado operacional normal. |
| Degradado 3 | O disco virtual está respondendo a comandos, mas não está sendo executado em um estado operacional ideal. |
| Estressado 4 | |
| Falha preditiva 5 | |
| Erro 6 | |
| Erro 7 não recuperável | |
| Começando 8 | |
| Parada 9 | |
| Parou 10 | O disco virtual está respondendo a comandos, mas não está sendo executado em um estado operacional ideal. |
| No Serviço 11 | O disco virtual está sendo configurado, mantido, limpo ou administrado de outra forma. |
| Sem contato 12 | |
| Perda de Comunicação 13 | |
| Abortado 14 | |
| Dormente 15 | |
| Entidade de suporte no erro 16 | |
| Concluída 17 | |
| Modo de energia 18 | |
| Realocação 19 | |
| 0xD002 Destacado | Esse valor é reservado para Windows. O disco virtual que é visível para o sistema host, mas não tem um objeto de dispositivo de disco. |
| 0xD003 incompleto | O disco virtual não tem redundância suficiente para reparar ou regenerar seus dados com êxito. |
OtherOperationalStatusDescription
Tipo de dados: string
Tipo de acesso: Somente leitura
Se OperationalStatus contiver Other, essa propriedade será uma cadeia de caracteres que contém o status operacional definido pelo fornecedor. Essa propriedade deverá ser NULL se OperationalStatus não contiver Other.
OtherUsageDescription
Tipo de dados: string
Tipo de acesso: Somente leitura
Se a propriedade Usage do disco virtual estiver definida como Other, essa propriedade deverá conter uma descrição do uso definido pelo fornecedor ou pelo usuário. Se Usage não estiver definido como Other, essa propriedade deverá ser NULL.
Layout de Paridade
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
O tipo de layout de paridade que está sendo usado para configurações de resiliência baseadas em paridade. Essa propriedade deverá ser NULL se o disco virtual não usar uma configuração de resiliência baseada em paridade.
Paridade não rotacionada (1)
Paridade Rotativa (2)
Redundância de disco físico
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
O número de discos físicos de backup que podem falhar sem comprometer a redundância de dados. Por exemplo: RAID 0 não pode tolerar falhas, RAID 5 pode tolerar uma única falha de unidade e RAID 6 pode tolerar duas falhas.
PhysicalSectorSize
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
Qualificadores: Unidades ("Bytes")
O tamanho do setor físico do disco virtual, em bytes.
Tipo de provisionamento
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório
O esquema de provisionamento para o disco virtual.
| Valor | Significado |
|---|---|
| Desconhecido 0 | O esquema de provisionamento é desconhecido. |
| Fino 1 | A capacidade do disco virtual é alocada sob demanda. |
| Corrigido 2 | A capacidade do disco virtual é totalmente alocada no momento da criação. |
RequestNoSinglePointOfFailure
Tipo de dados: booleano
Tipo de acesso: Somente leitura
Defina como TRUE para não solicitar nenhum ponto único de falha.
ResiliencySettingName
Tipo de dados: String
Tipo de acesso: Somente leitura
Qualificadores: Obrigatório, ModelCorrespondence {"MSFT_ResiliencySetting.Name"}
O nome da configuração de resiliência do disco virtual.
Tamanho
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
Qualificadores: Obrigatórios, Unidades ("Bytes")
O tamanho lógico, em bytes, do disco virtual.
Formato Único
Tipo de dados: UInt16
Tipo de acesso: Somente leitura
Qualificadores: obrigatórios, valores ( "Específico do fornecedor", "ID do fornecedor", "EUI64", "Nome FCPH", "Cadeia de caracteres de nome SCSI" ), ValueMap ("0", "1", "2", "3", "8"), ModelCorrespondence {"MSFT_StorageObject.UniqueId"}
O tipo de identificador usado na propriedade UniqueId que essa classe herda da classe MSFT_StorageObject. Esse identificador deve ser o identificador mais alto disponível usando a seguinte ordem de preferência: 8 (mais alto), 3, 2, 1, 0 (mais baixo).
Por exemplo, se o dispositivo de disco virtual expor identificadores do tipo 0, 1 e 3, UniqueId deverá ser o identificador do tipo 3 e UniqueIdFormat deverá ser definido como 3.
Descrição UniqueIdFormatDescription
Tipo de dados: String
Tipo de acesso: Somente leitura
Qualificadores: ModelCorrespondence {"MSFT_StorageObject.UniqueId"}, ModelCorrespondence {"MSFT_VirtualDisk.UniqueIdFormat"}
Determinados valores para UniqueIdFormat podem incluir vários subformatos. Essa propriedade é uma cadeia de caracteres de forma livre usada para descrever o formato específico usado em UniqueId.
Uso
Tipo de dados: UInt16
Tipo de acesso: leitura/gravação
Qualificadores: Obrigatório
O uso pretendido para este disco virtual.
Desconhecido (0)
Outros (1)
Irrestrito (2)
Reservado para ComputerSystem (o servidor de bloco) (3)
Reservado pelos Serviços de Replicação (4)
Reservado pelos Serviços de Migração (5)
Origem da réplica local (6)
Origem de réplica remota (7)
Destino de réplica local (8)
Destino de réplica remota (9)
Origem ou destino da réplica local (10)
Origem ou destino da réplica remota (11)
Destino de réplica delta (12)
Componente de elemento (13)
Reservado como Colaborador do Grupo (14)
Membro de volume composto (15)
Membro composto do VirtualDisk (16)
Reservado para poupar (17)
WriteCacheSize
Tipo de dados: UInt64
Tipo de acesso: Somente leitura
O tamanho do cache de gravação do disco virtual.
Comentários
Os discos virtuais são unidades de armazenamento utilizáveis com um conjunto expandido de atributos em comparação com os discos físicos. Exemplos dos atributos adicionais incluem resiliência e extensão de capacidade dinâmica.
LUNs e espaços de armazenamento são exemplos de discos virtuais.
Os discos virtuais, quando expostos ao Windows, aparecem como discos (Windows) para o restante da pilha do Windows.
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\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |