classe Msvm_VirtualHardDiskSettingData
Fornece dados de configuração para um disco rígido virtual.
A sintaxe a seguir é o código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.
Sintaxe
[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
string InstanceID;
string Caption = "Virtual Hard Disk Setting Data";
string Description = "Setting Data for a Virtual Hard Disk";
string ElementName;
uint16 Type;
uint16 Format;
string Path;
string ParentPath;
DATETIME ParentTimestamp;
string ParentIdentifier;
uint64 MaxInternalSize;
uint32 BlockSize;
uint32 LogicalSectorSize;
uint32 PhysicalSectorSize;
string VirtualDiskId;
uint64 DataAlignment;
uint16 PmemAddressAbstractionType;
boolean IsPmemCompatible;
};
Membros
A classe Msvm_VirtualHardDiskSettingData tem estes tipos de membros:
Propriedades
A classe Msvm_VirtualHardDiskSettingData tem essas propriedades.
-
BlockSize
-
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
O tamanho do bloco usado pelo disco rígido virtual, em bytes.
-
-
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 "Dados de Configuração de Disco Rígido Virtual".
-
-
DataAlignment
-
-
Tipo de dados: uint64
-
Tipo de acesso: leitura/gravação
Especifica o alinhamento desejado, em bytes, para a carga de dados do disco virtual
Observação
Adicionado no Windows 10, versão 1709.
-
-
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 "Configurando dados para um disco rígido virtual".
-
-
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.
-
-
Formato
-
-
Tipo de dados: uint16
-
Tipo de acesso: leitura/gravação
O formato do disco rígido virtual. Esse será um dos valores a seguir.
-
-
VHD (2)
-
VHDX (3)
-
VHDSet (4)
-
Observação
Adicionado em Windows 10 e Windows Server 2016.
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_SettingData.
IsPmemCompatible
-
Tipo de dados: booliano
-
Tipo de acesso: leitura/gravação
Especifica se o disco virtual pode ser usado como repositório de backup para um dispositivo de memória persistente.
Observação
Adicionado no Windows 10, versão 1709.
LogicalSectorSize
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
O tamanho do setor lógico usado pelo disco rígido virtual, em bytes.
MaxInternalSize
-
Tipo de dados: uint64
-
Tipo de acesso: leitura/gravação
O tamanho máximo do disco rígido virtual como acessível pela máquina virtual, em bytes. Esse tamanho será arredondado para o próximo maior múltiplo do tamanho do setor.
ParentIdentifier
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
O GUID usado para identificar exclusivamente o pai do disco rígido virtual. Se o disco rígido virtual não tiver um pai, esse campo estará vazio.
Observação
Adicionado em Windows 10 e Windows Server 2016.
ParentPath
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
O pai do disco rígido virtual. Se o disco rígido virtual não tiver um pai, essa propriedade estará vazia.
ParentTimestamp
-
Tipo de dados: DATETIME
-
Tipo de acesso: Somente leitura
O carimbo de data/hora do pai do disco rígido virtual. Se o disco rígido virtual não tiver um pai, esse campo estará vazio.
Observação
Adicionado em Windows 10 e Windows Server 2016.
Caminho
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
O caminho totalmente qualificado do disco rígido virtual.
PhysicalSectorSize
-
Tipo de dados: uint32
-
Tipo de acesso: leitura/gravação
O tamanho do setor físico usado pelo disco rígido virtual, em bytes.
PmemAddressAbstractionType
-
Tipo de dados: uint16
-
Tipo de acesso: leitura/gravação
O método de abstração de endereço de memória persistente a ser usado com esse disco virtual.
Observação
Adicionado no Windows 10, versão 1709.
Nenhum (0)
BTT (1)
Desconhecido (65535)
Tipo
-
Tipo de dados: uint16
-
Tipo de acesso: leitura/gravação
O tipo de disco rígido virtual. Esse será um dos valores a seguir.
Corrigido (2)
Dinâmico (3)
Diferenciação (4)
VirtualDiskId
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: leitura/gravação
O GUID usado para identificar exclusivamente o disco virtual.
Quando o método Msvm_ImageManagementService.GetVirtualHardDiskSettingData retorna uma instância de Msvm_VirtualHardDiskSettingData, o cliente pode usar essa propriedade para obter a ID de disco exclusiva do VHD.
Na detecção de conflitos ou de outra forma, um cliente pode definir o valor VirtualDiskId como um novo GUID e passar essa instância de Msvm_VirtualHardDiskSettingData para o método Msvm_ImageManagementService.SetVirtualHardDiskSettingData para alterar a ID de disco do VHD. Se o VHD não for um VHD VHDX ou se o VHD estiver anexado, a operação falhará. A operação também falhará se o valor passado estiver malformado, ou seja, não um GUID ou tiver todos os 0s. A operação terá êxito silenciosamente se o valor passado for o mesmo que a ID do disco atual.
Os erros gerados pela função SetVirtualDiskInformation são gerados por essa propriedade. Um cliente também pode usar o mesmo mecanismo para fornecer o valor VirtualDiskId na criação do VHD por meio do método Msvm_ImageManagementService.CreateVirtualHardDisk no mesmo namespace. Isso pode ser usado para criar VHDS VHD1 ou VHD2.
Windows 8.1: esse valor não tem suporte até Windows 8.1 e Windows Server 2012 R2.
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 |
|