Compartilhar via


Classe Win32_LogicalDisk

A classe WMIWin32_LogicalDisk representa uma fonte de dados que é resolvida para um dispositivo de armazenamento local real em um sistema de computador que executa o Windows.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4B7-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_LogicalDisk : CIM_LogicalDisk
{
  uint16   Access;
  uint16   Availability;
  uint64   BlockSize;
  string   Caption;
  boolean  Compressed;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  uint32   DriveType;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  string   FileSystem;
  uint64   FreeSpace;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaximumComponentLength;
  uint32   MediaType;
  string   Name;
  uint64   NumberOfBlocks;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   ProviderName;
  string   Purpose;
  boolean  QuotasDisabled;
  boolean  QuotasIncomplete;
  boolean  QuotasRebuilding;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  boolean  SupportsDiskQuotas;
  boolean  SupportsFileBasedCompression;
  string   SystemCreationClassName;
  string   SystemName;
  boolean  VolumeDirty;
  string   VolumeName;
  string   VolumeSerialNumber;
};

Membros

A classe Win32_LogicalDisk tem estes tipos de membros:

Métodos

A classe Win32_LogicalDisk tem esses métodos.

Método Descrição
Chkdsk Invoca a operação Chkdsk no disco.
ExcludeFromAutochk Exclui discos da operação Chkdsk a serem executados na próxima reinicialização.
Redefinir Não implementado. Para obter mais informações sobre como implementar esse método, consulte o método Reset no CIM_LogicalDisk para obter a documentação.
ScheduleAutoChk Agenda o Chkdsk a ser executado na próxima reinicialização se o sujo bit tiver sido definido.
SetPowerState Não implementado. Para obter mais informações sobre como implementar esse método, consulte o método SetPowerState no CIM_LogicalDisk.

Propriedades

A classe Win32_LogicalDisk tem essas propriedades.

Acesso

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Tipo de acesso à mídia disponível.

Essa propriedade é herdada de CIM_StorageExtent.

Desconhecido (0)

Legível (1)

Gravável (2)

Gravável

Leitura/gravação com suporte (3)

Gravar uma vez (4)

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado operacional|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidade e status do dispositivo.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Energia completa/em execução (3)

Energia completa ou em execução

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Offline

Desativada (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Economia de energia – Desconhecido (13)

O dispositivo é conhecido por estar em um modo de economia de energia, mas seu status exato é desconhecido.

Economia de energia – modo de energia baixa (14)

O dispositivo está em um estado de economia de energia, mas ainda funcionando e pode apresentar desempenho degradado.

Economia de energia – espera (15)

O dispositivo não está funcionando, mas pode ser levado à potência total rapidamente.

Ciclo de Energia (16)

Economia de energia – Aviso (17)

O dispositivo está em um estado de aviso, mas também em um modo de economia de energia.

Pausado (18)

O dispositivo está em pausa.

Não Pronto (19)

O dispositivo não está pronto.

Não Configurado (20)

O dispositivo não está configurado.

Quiesced (21)

O dispositivo está silencioso.

BlockSize

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageAllocationUnits"), Unidades ("bytes")

Tamanho, em bytes, dos blocos que formam essa extensão de armazenamento. Se for desconhecido ou se um conceito de bloco não for válido (por exemplo, para extensões de agregação, memória ou discos lógicos), insira 1.

Essa propriedade é herdada de CIM_StorageExtent.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Caption")

Descrição curta do objeto uma cadeia de caracteres de uma linha.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Compactado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivos| GetVolumeInformation| FS_VOL_IS_COMPRESSED")

Se True, o volume lógico existirá como uma única entidade compactada, como um volume DoubleSpace. Se houver suporte para compactação baseada em arquivo, como no NTFS, essa propriedade será False.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Código de erro do Windows Configuration Manager.

Essa propriedade é herdada de CIM_LogicalDevice.

Este dispositivo está funcionando corretamente. (0)

O dispositivo está funcionando corretamente.

Este dispositivo não está configurado corretamente. (1)

O dispositivo não está configurado corretamente.

O Windows não pode carregar o driver para este dispositivo. (2)

O driver deste dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

O driver para este dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos.

Este dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)

O dispositivo não está funcionando corretamente. Um de seus drivers ou o registro pode estar corrompido.

O driver deste dispositivo precisa de um recurso que o Windows não possa gerenciar. (5)

O driver para o dispositivo requer um recurso que o Windows não pode gerenciar.

A configuração de inicialização deste dispositivo está em conflito com outros dispositivos. (6)

A configuração de inicialização do dispositivo está em conflito com outros dispositivos.

Não é possível filtrar. (7)

O carregador de driver para o dispositivo está ausente. (8)

O carregador de driver para o dispositivo está ausente.

Este dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos para o dispositivo incorretamente. (9)

O dispositivo não está funcionando corretamente. O firmware de controle está relatando incorretamente os recursos para o dispositivo.

Este dispositivo não pode ser iniciado. (10)

O dispositivo não pode ser iniciado.

Este dispositivo falhou. (11)

Falha no dispositivo.

Este dispositivo não pode encontrar recursos gratuitos suficientes que ele pode usar. (12)

O dispositivo não pode encontrar recursos gratuitos suficientes para usar.

O Windows não pode verificar os recursos deste dispositivo. (13)

O Windows não pode verificar os recursos do dispositivo.

Este dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)

O dispositivo não pode funcionar corretamente até que o computador seja reiniciado.

Este dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)

O dispositivo não está funcionando corretamente devido a um possível problema de renumeração.

O Windows não pode identificar todos os recursos que este dispositivo usa. (16)

O Windows não pode identificar todos os recursos que o dispositivo usa.

Este dispositivo está solicitando um tipo de recurso desconhecido. (17)

O dispositivo está solicitando um tipo de recurso desconhecido.

Reinstale os drivers para este dispositivo. (18)

Os drivers de dispositivo devem ser reinstalados.

Falha ao usar o carregador VxD. (19)

Seu registro pode estar corrompido. (20)

O Registro pode estar corrompido.

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. O Windows está removendo este dispositivo. (21)

Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware. O Windows está removendo o dispositivo.

Este dispositivo está desabilitado. (22)

O dispositivo está desabilitado.

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. (23)

Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware.

Este dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)

O dispositivo não está presente, não está funcionando corretamente ou não tem todos os seus drivers instalados.

O Windows ainda está configurando este dispositivo. (25)

O Windows ainda está configurando o dispositivo.

O Windows ainda está configurando este dispositivo. (26)

O Windows ainda está configurando o dispositivo.

Este dispositivo não tem uma configuração de log válida. (27)

O dispositivo não tem uma configuração de log válida.

Os drivers para este dispositivo não estão instalados. (28)

Os drivers de dispositivo não estão instalados.

Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)

O dispositivo está desabilitado. O firmware do dispositivo não forneceu os recursos necessários.

Este dispositivo está usando um recurso irq (solicitação de interrupção) que outro dispositivo está usando. (30)

O dispositivo está usando um recurso IRQ que outro dispositivo está usando.

Este dispositivo não está funcionando corretamente porque o Windows não pode carregar os drivers necessários para este dispositivo. (31)

O dispositivo não está funcionando corretamente. O Windows não pode carregar os drivers de dispositivo necessários.

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Se True, o dispositivo está usando uma configuração definida pelo usuário.

Essa propriedade é herdada de CIM_LogicalDevice.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

Nome da primeira classe concreta a ser exibida na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades de chave da classe , a propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_LogicalDevice.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave, Substituição ("DeviceId"), MappingStrings ("WMI")

Identificador exclusivo do disco lógico de outros dispositivos no sistema.

Essa propriedade é herdada de CIM_LogicalDevice.

Para obter um exemplo de código que recupera essa propriedade, consulte a seção Comentários, abaixo.

Drivetype

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| FileFunctions| GetDriveType")

Valor numérico que corresponde ao tipo de unidade de disco que esse disco lógico representa.

Desconhecido (0)

Sem Diretório Raiz (1)

Disco Removível (2)

Disco Local (3)

Unidade de Rede (4)

Disco Compacto (5)

Disco de RAM (6)

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, o erro relatado em LastErrorCode agora será limpo.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Mais informações sobre o erro registrado em LastErrorCode e informações sobre quaisquer ações corretivas que possam ser executadas.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorMethodology

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Tipo de detecção e correção de erros com suporte nessa extensão de armazenamento.

Essa propriedade é herdada de CIM_StorageExtent.

Filesystem

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivosGetVolumeInformation)

Sistema de arquivos no disco lógico.

Exemplo: "NTFS"

FreeSpace

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: unidades ("bytes")

Espaço, em bytes, disponível no disco lógico.

Essa propriedade é herdada de CIM_LogicalDisk.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Data e hora em que o objeto foi instalado. Essa propriedade não requer um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Último código de erro relatado pelo dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

MaximumComponentLength

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivosGetVolumeInformation)

Comprimento máximo de um componente de nome de arquivo compatível com a unidade do Windows. Um componente filename é aquela parte de um nome de arquivo entre barras invertidas. O valor pode ser usado para indicar que nomes longos são compatíveis com o sistema de arquivos especificado. Por exemplo, para um sistema de arquivos FAT que dá suporte a nomes longos, a função armazena o valor 255, em vez do indicador 8.3 anterior. Nomes longos também podem ter suporte em sistemas que usam o sistema de arquivos NTFS.

Exemplo: 255

MediaType

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções de entrada e saída do dispositivo| DeviceIoControl")

Tipo de mídia atualmente presente na unidade lógica. Esse valor será um dos valores da enumeração MEDIA_TYPE definida em Winioctl.h. O valor pode não ser exato para unidades removíveis se atualmente não houver mídia na unidade.

O formato é desconhecido (0)

Disco disquete de 5 polegadas (1)

Disco disquete de 5 1/4 polegadas - 1,2 MB - 512 bytes/setor

Disco disquete de 3 polegadas (2)

Disco disquete de 3 1/2 polegadas - 1,44 MB -512 bytes/setor

Disco disquete de 3 polegadas (3)

Disco disquete de 3 1/2 polegadas - 2,88 MB - 512 bytes/setor

Disco disquete de 3 polegadas (4)

Disco disquete de 3 1/2 polegadas - 20,8 MB - 512 bytes/setor

Disco disquete de 3 polegadas (5)

Disco disquete de 3 1/2 polegadas - 720 KB - 512 bytes/setor

Disco disquete de 5 polegadas (6)

Disco disquete de 5 1/4 polegadas - 360 KB - 512 bytes/setor

Disco disquete de 5 polegadas (7)

Disco disquete de 5 1/4 polegadas - 320 KB - 512 bytes/setor

Disco disquete de 5 polegadas (8)

Disco disquete de 5 1/4 polegadas - 320 KB - 1024 bytes/setor

Disco disquete de 5 polegadas (9)

Disco disquete de 5 1/4 polegadas - 180 KB - 512 bytes/setor

Disco disquete de 5 polegadas (10)

Disco disquete de 5 1/4 polegadas - 160 KB - 512 bytes/setor

Mídia removível diferente de disquete (11)

Mídia de disco rígido fixa (12)

Disco disquete de 3 polegadas (13)

Disco disquete de 3 1/2 polegadas - 120 MB - 512 bytes/setor

Disco disquete de 3 polegadas (14)

Disco disquete de 3 1/2 polegadas - 640 KB - 512 bytes/setor

Disco disquete de 5 polegadas (15)

Disco disquete de 5 1/4 polegadas - 640 KB - 512 bytes/setor

Disco disquete de 5 polegadas (16)

Disco disquete de 5 1/4 polegadas - 720 KB - 512 bytes/setor

Disco disquete de 3 polegadas (17)

Disco disquete de 3 1/2 polegadas - 1,2 MB - 512 bytes/setor

Disco disquete de 3 polegadas (18)

Disco disquete de 3 1/2 polegadas – 1,23 MB – 1024 bytes/setor

Disco disquete de 5 polegadas (19)

Disco disquete de 5 1/4 polegadas – 1,23 MB – 1024 bytes/setor

Disco disquete de 3 polegadas (20)

Disco disquete de 3 1/2 polegadas - 128 MB - 512 bytes/setor

Disco disquete de 3 polegadas (21)

Disco disquete de 3 1/2 polegadas - 230 MB - 512 bytes/setor

Disco disquete de 8 polegadas (22)

Disquete de 8 polegadas – 256 KB – 128 bytes/setor

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

NumberOfBlocks

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIB. IETF| HOST-RESOURCES-MIB.hrStorageSize")

Número total de blocos consecutivos, cada bloco o tamanho do valor contido na propriedade BlockSize , que formam essa extensão de armazenamento. O tamanho total da extensão de armazenamento pode ser calculado multiplicando o valor da propriedade BlockSize pelo valor dessa propriedade. Se o valor de BlockSize for 1, essa propriedade será o tamanho total da extensão de armazenamento.

Essa propriedade é herdada de CIM_StorageExtent.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

PNPDeviceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

O Windows Plug and Play identificador de dispositivo do dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Exemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Matriz das funcionalidades específicas relacionadas à energia de um dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

Sem suporte (1)

Desabilitado (2)

Habilitado (3)

Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto exato de recursos é desconhecido ou as informações não estão disponíveis.

Modos de economia de energia inseridos automaticamente (4)

O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.

Power State Settable (5)

Há suporte para o método SetPowerState . Esse método é encontrado na classe de CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Criando classes MOF (Formato de Objeto Gerenciado).

Power Cycling com suporte (6)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle).

Com suporte para Ligar /Hora (7)

Com suporte para Power-On cronometrado

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle) e Time definido como uma data e hora específicas, ou intervalo, para ativação.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, o dispositivo pode ser gerenciado por energia (pode ser colocado no modo de suspensão e assim por diante). Essa propriedade não indica que os recursos de gerenciamento de energia estão habilitados no momento, apenas que o dispositivo lógico é capaz de gerenciamento de energia.

Essa propriedade é herdada de CIM_LogicalDevice.

ProviderName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções de rede do Windows| WNetGetConnection")

Caminho de rede para o dispositivo lógico.

Finalidade

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Cadeia de caracteres de forma livre que descreve a mídia e seu uso.

Essa propriedade é herdada de CIM_StorageExtent.

Cotas Desabilitadas

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica que o gerenciamento de cotas não está habilitado (TRUE) nesse sistema.

QuotasIncomplete

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica que o gerenciamento de cotas foi usado, mas foi desabilitado (True). Incompleto refere-se às informações deixadas no sistema de arquivos depois que o gerenciamento de cotas foi desabilitado.

CotasRebuilding

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, indica que o sistema de arquivos está no processo ativo de compilação de informações e configuração do disco para o gerenciamento de cotas.

Tamanho

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: unidades ("bytes")

Tamanho da unidade de disco.

Essa propriedade é herdada de CIM_LogicalDisk.

Para obter um exemplo de código que recupera essa propriedade, consulte a seção Comentários, abaixo.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10), DisplayName ("Status")

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado operacional|003.3")

Estado do dispositivo lógico. Se essa propriedade não se aplicar ao dispositivo lógico, o valor 5 (Não Aplicável) deverá ser usado.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Habilitado (3)

Desabilitado (4)

Não aplicável (5)

SupportsDiskQuotas

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se True, esse volume dá suporte a cotas de disco.

SupportsFileBasedCompression

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivos| GetVolumeInformation| FS_FILE_COMPRESSION")

Se True, a partição de disco lógico dá suporte à compactação baseada em arquivo, como é o caso do sistema de arquivos NTFS. Essa propriedade é False quando a propriedade Compactada é True.

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

Valor da propriedade CreationClassName do computador de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: propagados ("CIM_System. Nome"), CIM_Key

Nome do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

VolumeDirty

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("FSCTL_IS_VOLUME_DIRTY")

Se True, o disco exigirá que o ChkDsk seja executado na próxima reinicialização. Essa propriedade só é aplicável às instâncias de disco lógico que representam um disco físico no computador. Não é aplicável a unidades lógicas mapeadas.

VolumeName

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivosGetVolumeInformation)

Nome do volume do disco lógico.

Restrições: máximo de 32 caracteres.

Para obter um exemplo de código que recupera essa propriedade, consulte a seção Comentários, abaixo.

VolumeSerialNumber

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Funções do sistema de arquivosGetVolumeInformation)

Número de série de volume do disco lógico.

Restrições: máximo de 11 caracteres.

Exemplo: "A8C3-D032"

Comentários

A classe Win32_LogicalDisk é derivada de CIM_LogicalDisk que deriva de CIM_StorageExtent. A classe CIM_StorageExtent é derivada de CIM_LogicalDevice.

Uma unidade de disco físico é a base de qualquer sistema de gerenciamento de armazenamento. No entanto, após a instalação de uma unidade de disco físico, nem os usuários nem os administradores do sistema normalmente lidam diretamente com o hardware. Em vez disso, os usuários e os administradores do sistema interagem com as unidades lógicas que foram criadas no disco.

Uma unidade lógica é uma subdivisão de uma partição que recebeu sua própria letra de unidade. (É possível ter uma partição que não tenha sido atribuída a uma letra da unidade.) Quando você fala sobre a unidade C ou a unidade D, você está se referindo a uma unidade lógica em vez de uma unidade de disco físico. Da mesma forma, quando você salva um documento para conduzir E, você está salvando-o na unidade lógica. Os discos físicos compõem o hardware que compõe uma unidade, incluindo componentes como cabeças, setores e cilindros. As unidades lógicas, por outro lado, têm propriedades como espaço em disco, espaço em disco disponível e letras de unidade.

Observação

A classe Win32_LogicalDisk pode ser usada apenas para enumerar as propriedades das unidades de disco locais. No entanto, você pode usar a classe Win32_MappedLogicalDisk para enumerar as propriedades das unidades de rede mapeadas.

Exemplos

Você pode encontrar outros exemplos usando Win32_LogicalDisk para obter dados de disco ou volume no tópico Tarefas do WMI: Discos e Sistemas de Arquivos .

O exemplo de código VBScript do WMI Information Retriever na Galeria do TechNet usa a classe Win32_LogicalDisk para recuperar informações de hardware de vários computadores remotos.

Obter informações de disco usando wmi/cim... O exemplo de código do PowerShell na Galeria do TechNet usa Win32_LogicalDisk para recuperar DeviceID, VolumeName e Size de um dispositivo de destino. Em particular, este exemplo inclui um tratamento rigoroso de exceções e retorna um único objeto por computador, em vez de por disco.

O script corporativo geralmente envolve a configuração de hardware e software em computadores remotos; Por sua vez, isso exige que você saiba, com antecedência, o tipo de unidades de disco instaladas em um computador. Por exemplo, um script que instala um aplicativo na unidade E só funcionará se a unidade E for um disco rígido. Se a unidade E representar um disquete ou uma unidade CD-ROM, o script falhará. O código a seguir identifica as unidades e os tipos de unidade instalados em um computador

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk")
For Each objDisk in colDisks
 Wscript.Echo "DeviceID: "& objDisk.DeviceID 
 Select Case objDisk.DriveType
 Case 1
 Wscript.Echo "No root directory."
 Case 2
 Wscript.Echo "DriveType: Removable drive."
 Case 3
 Wscript.Echo "DriveType: Local hard disk."
 Case 4
 Wscript.Echo "DriveType: Network disk." 
 Case 5
 Wscript.Echo "DriveType: Compact disk." 
 Case 6
 Wscript.Echo "DriveType: RAM disk." 
 Case Else
 Wscript.Echo "Drive type could not be determined."
 End Select
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...
{
   string strComputer = ".";
            
   ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
   ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk");
   ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
   ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

   foreach (ManagementObject objDisk in colDisks)
   {
      Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
                
      switch ((uint)(objDisk["DriveType"]))
      {
         case 1: {   Console.WriteLine("No root directory.");
                     break;}
         case 2: {   Console.WriteLine("DriveType: Removable drive."); 
                     break;}
         case 3: {   Console.WriteLine("DriveType: Local hard disk.");
                     break;}
         case 4: {   Console.WriteLine("DriveType: Network disk.");
                     break;}
         case 5: {   Console.WriteLine("DriveType: Compact disk.");
                     break;}
         case 6: {   Console.WriteLine("DriveType: RAM disk.");
                     break;}
         default: {  Console.WriteLine("Drive type could not be determined.");
                     break;}
      }
      //Readline is in here so the user can see the result before the code exists
      Console.ReadLine();
   }
}

Os exemplos a seguir enumeram o espaço livre em todas as unidades de disco rígido em um computador.

Const HARD_DISK = 3
strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colDisks = objWMIService.ExecQuery ("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " & HARD_DISK & "")
For Each objDisk in colDisks
 Wscript.Echo "Device ID: " & objDisk.DeviceID 
 Wscript.Echo "Free Disk Space: " & objDisk.FreeSpace
Next

//be sure to References->Add->System.Management to your project
using System.Management;
...

const int HARD_DISK = 3;
string strComputer = ".";

ManagementScope namespaceScope = new ManagementScope("\\\\" + strComputer + "\\ROOT\\CIMV2");
ObjectQuery diskQuery = new ObjectQuery("SELECT * FROM Win32_LogicalDisk WHERE DriveType = " + HARD_DISK + "");
ManagementObjectSearcher mgmtObjSearcher = new ManagementObjectSearcher(namespaceScope, diskQuery);
ManagementObjectCollection colDisks = mgmtObjSearcher.Get();

foreach (ManagementObject objDisk in colDisks)
{
    Console.WriteLine("Device ID : {0}", objDisk["DeviceID"]);
    Console.WriteLine("Free Disk Space : {0}", objDisk["FreeSpace"]);
    Console.ReadLine();
}

O exemplo de código a seguir retorna o tipo de sistema de arquivos (FAT, NTFS, FAT32 e assim por diante) usado em cada unidade em um computador.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set colDisks = objWMIService.ExecQuery ("Select * from Win32_LogicalDisk")
For Each objDisk in colDisks
    Wscript.Echo "DeviceID: "& vbTab &  objDisk.DeviceID  
    Wscript.Echo "File System: "& vbTab & objDisk.FileSystem
Next

Get-WMIObject Win32_LogicalDisk | Select DeviceID, FileSystem | Format=Table -AutoSize

O exemplo de código do PowerShell a seguir recupera informações adicionais sobre os discos locais lógicos.

Write-Host "Drive information for $env:ComputerName"

Get-WmiObject -Class Win32_LogicalDisk |
    Where-Object {$_.DriveType -ne 5} |
    Sort-Object -Property Name | 
    Select-Object Name, VolumeName, FileSystem, Description, VolumeDirty, `
        @{"Label"="DiskSize(GB)";"Expression"={"{0:N}" -f ($_.Size/1GB) -as [float]}}, `
        @{"Label"="FreeSpace(GB)";"Expression"={"{0:N}" -f ($_.FreeSpace/1GB) -as [float]}}, `
        @{"Label"="%Free";"Expression"={"{0:N}" -f ($_.FreeSpace/$_.Size*100) -as [float]}} |
    Format-Table -AutoSize

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Cim_logicaldisk

Classes de hardware do sistema de computador

Tarefas do WMI: discos e sistemas de arquivos