Classe Win32_MappedLogicalDisk
A classe WMIWin32_MappedLogicalDisk representa dispositivos de armazenamento de rede mapeados como discos lógicos no sistema de computador.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.
Sintaxe
[Dynamic, Provider("CIMWin32"), UUID("{BCF02FFE-5560-4de2-B419-272918693426}"), AMENDMENT]
class Win32_MappedLogicalDisk : CIM_LogicalDisk
{
uint16 Access;
uint16 Availability;
uint64 BlockSize;
string Caption;
boolean Compressed;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
string ErrorMethodology;
string FileSystem;
uint64 FreeSpace;
datetime InstallDate;
uint32 LastErrorCode;
uint32 MaximumComponentLength;
string Name;
uint64 NumberOfBlocks;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string ProviderName;
string Purpose;
boolean QuotasDisabled;
boolean QuotasIncomplete;
boolean QuotasRebuilding;
string SessionID;
uint64 Size;
string Status;
uint16 StatusInfo;
boolean SupportsDiskQuotas;
boolean SupportsFileBasedCompression;
string SystemCreationClassName;
string SystemName;
string VolumeName;
string VolumeSerialNumber;
};
Membros
A classe Win32_MappedLogicalDisk tem estes tipos de membros:
Métodos
A classe Win32_MappedLogicalDisk tem esses métodos.
| Método | Descrição |
|---|---|
| Redefinir | Não implementado. Para implementar esse método, consulte o método Reset no CIM_LogicalDisk. |
| SetPowerState | Não implementado. Para implementar esse método, consulte o método SetPowerState em CIM_LogicalDisk. |
Propriedades
A classe Win32_MappedLogicalDisk tem essas propriedades.
-
Acesso
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Estado de acesso do dispositivo.
Essa propriedade é herdada de CIM_StorageExtent.
-
-
Desconhecido (0)
-
Legível (1)
-
Gravável (2)
-
Suporte para leitura/gravação (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 em execução/completa (3)
Energia completa ou em execução
Aviso (4)
Em Teste (5)
Não aplicável (6)
Desligar (7)
Off Line (8)
Offline
Desativação do serviço (9)
Degradado (10)
Não Instalado (11)
Erro de instalação (12)
Power Save – Desconhecido (13)
O dispositivo é conhecido por estar em um modo de economia de energia, mas sua status exata é desconhecida.
Economia de energia – modo de energia baixa (14)
O dispositivo está em um estado de economia de energia, mas ainda funciona e pode exibir desempenho degradado.
Power Save – Espera (15)
O dispositivo não está funcionando, mas pode ser levado à potência total rapidamente.
Ciclo de Energia (16)
Power Save – Aviso (17)
O dispositivo está em um estado de aviso, embora 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 esse conceito não for válido para o tipo de dispositivo, o valor será 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.
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 arquivo será compactado.
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 , essa 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 da matriz de memória.
Essa propriedade é herdada de CIM_LogicalDevice.
Exemplo: "Matriz de Memória 1"
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 as ações corretivas que podem ser executadas.
Essa propriedade é herdada de CIM_LogicalDevice.
ErrorMethodology
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
Tipos de verificação de erros usados pelo hardware.
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)
Tipo de acesso: Somente leitura
Sistema de arquivos no disco lógico.
Exemplo: "NTFS"
FreeSpace
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("bytes")
Espaço 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")
Tipo de acesso: Somente leitura
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)
Contém o comprimento máximo de um componente de nome de arquivo compatível com a unidade do Windows.
Exemplo: 255
Nome
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Name")
Rótulo de objeto.
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). A 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")
Nome do 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
Se True, o gerenciamento de cotas não está habilitado para esse volume.
QuotasIncomplete
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se True, o gerenciamento de cotas foi usado, mas foi desabilitado. Incompleto refere-se às informações deixadas no sistema de arquivos após o gerenciamento de cotas ter sido desabilitado.
CotasRebuilding
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Se true, o sistema de arquivos está configurando para o gerenciamento de cotas.
Sessionid
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: Chave
ID da sessão do usuário. O usuário pode estar conectado usando um logon local ou uma sessão de terminal.
Tamanho
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
-
Qualificadores: unidades ("bytes")
Tamanho do disco lógico.
Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.
Essa propriedade é herdada de CIM_LogicalDisk.
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 funcionar corretamente, mas prevê uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". A status de Serviço se aplica ao trabalho administrativo, como espelho-resilvering de um disco, recarregar 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 são:
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, o sistema de arquivos no qual essa unidade de rede é mapeada 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 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.
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. Esse valor de propriedade pode ter no máximo 32 caracteres.
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. Esse valor de propriedade pode ter no máximo 11 caracteres.
Essa propriedade é herdada de CIM_LogicalDevice.
Exemplo: "A8C3-D032"
Comentários
As instâncias retornadas para essa classe são as seguintes, supondo que o usuário A esteja enumerando as instâncias:
O provedor procura uma sessão de logon do usuário A nesse computador:
- Se houver uma (e apenas uma) sessão de logon, o provedor retornará as unidades mapeadas dessa sessão.
- Se houver mais de uma sessão para o usuário A no computador, nenhuma instância de unidade mapeada será retornada (porque o provedor não tem uma maneira razoável de decidir qual sessão usar).
Se não houver sessões do usuário A em execução e houver um usuário B conectado localmente:
Se houver uma única sessão para o usuário B, o provedor representará A e retornará as unidades mapeadas do usuário B. Esse caso dá suporte ao cenário de Helpdesk que deseja ver as instâncias de um usuário conectado localmente. No entanto, se as instâncias são retornadas depende das configurações de Política de Segurança Local no Painel de Controle Ferramentas Administrativas. Se a política a seguir estiver definida como "Criador de Objetos", nenhuma instância de unidade mapeada será retornada, mesmo que A seja membro do grupo Administradores:
"Objeto do sistema: proprietário padrão para objetos criados por membros do grupo de administradores."
Novamente, se houver mais de uma sessão do usuário B em execução no computador, o provedor não terá como decidir qual usar. Nesse caso, nenhuma instância de unidade mapeada é retornada.
Para obter mais informações sobre como usar Win32_MappedLogicalDisk, consulte Como posso determinar quais unidades são mapeadas para compartilhamentos de rede?
Exemplos
O snippet do PowerShell a seguir mostra unidades mapeadas.
Get-WmiObject Win32_MappedLogicalDisk | Select Name, ProviderName, FileSystem, Size, FreeSpace | Format-Table
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de