Win32_MappedLogicalDisk 類別

  • 發行項

Win32_MappedLogicalDiskWMI 類別代表對應為電腦系統上邏輯磁片的網路儲存裝置。

下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性和方法依字母順序排列，而非 MOF 順序。

語法

[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;
};

成員

Win32_MappedLogicalDisk類別具有下列類型的成員：

方法

Win32_MappedLogicalDisk類別具有這些方法。

方法 描述
重設 未實作。 若要實作此方法，請參閱CIM_LogicalDisk中的Reset方法。
SetPowerState 未實作。 若要實作此方法，請參閱CIM_LogicalDisk中的SetPowerState方法。

屬性

Win32_MappedLogicalDisk類別具有這些屬性。

存取

資料類型： uint16

存取類型：唯讀

裝置存取狀態。

此屬性繼承自 CIM_StorageExtent。

未知 (0)

可讀取 (1)

可寫入 (2)

支援讀取/寫入 (3)

寫入一次 (4)

可用性

資料類型： uint16

存取類型：唯讀

限定詞： MappingStrings (「MIF。DMTF|操作狀態|003.5「、」MIB。IETF|HOST-RESOURCES-MIB.hrDeviceStatus「)

裝置的可用性和狀態。

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

執行/完整電源 (3)

執行或完整電源

警告 (4)

在測試 (5)

不適用 (6)

關閉電源 (7)

離線 (8)

離線

( 9)

降級 (10)

未安裝 (11)

安裝錯誤 (12)

電源儲存 - 未知 (13)

裝置已知處於省電模式，但其確切狀態不明。

省電 - 低電源模式 (14)

裝置處於省電狀態，但仍正常運作，而且可能會呈現效能降低。

電源儲存 - 待命 (15)

裝置無法運作，但可快速進入完整電源。

Power Cycle (16)

電源儲存 - 警告 (17)

裝置處於警告狀態，但也會處於省電模式。

暫停 (18)

裝置已暫停。

未就緒 (19)

裝置未就緒。

未 設定 (20)

裝置未設定。

停止 (21)

裝置很無訊息。

BlockSize

資料類型： uint64

存取類型：唯讀

限定詞： MappingStrings (「MIB。IETF|HOST-RESOURCES-MIB.hrStorageAllocationUnits「) ， Units (」bytes「)

大小，以位元組為單位，構成此儲存範圍的區塊。 如果這個概念對裝置類型無效，則值為 1。

此屬性繼承自 CIM_StorageExtent。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

標題

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (64) 、 DisplayName (「Caption」)

物件的簡短描述。

此屬性繼承自 CIM_ManagedSystemElement。

Compressed

資料類型： 布林值

存取類型：唯讀

限定詞： MappingStrings (「Win32API|檔案系統函式|GetVolumeInformation|FS_VOL_IS_COMPRESSED「)

如果 為 True，則會壓縮檔案。

ConfigManagerErrorCode

資料類型： uint32

存取類型：唯讀

限定詞： 架構 (「Win32」)

Windows Configuration Manager錯誤碼。

此屬性繼承自 CIM_LogicalDevice。

此裝置正常運作。 (0)

裝置正常運作。

此裝置未正確設定。 (1)

裝置未正確設定。

Windows無法載入此裝置的驅動程式。 (2)

此裝置的驅動程式可能已損毀，或者您的系統可能會在記憶體或其他資源上執行不足。 (3)

此裝置的驅動程式可能已損毀，或系統記憶體不足或其他資源。

此裝置無法正常運作。其中一個驅動程式或您的登錄可能已損毀。 (4)

裝置無法正常運作。 其中一個驅動程式或登錄可能已損毀。

此裝置的驅動程式需要Windows無法管理的資源。 (5)

裝置的驅動程式需要Windows無法管理的資源。

此裝置的開機設定與其他裝置衝突。 (6)

裝置的開機設定與其他裝置衝突。

無法篩選。 (7)

遺失裝置的驅動程式載入器。 (8)

遺失裝置的驅動程式載入器。

此裝置無法正常運作，因為控制韌體未正確報告裝置的資源。 (9)

裝置無法正常運作。 控制韌體不正確地報告裝置的資源。

此裝置無法啟動。 (10)

裝置無法啟動。

此裝置失敗。 (11)

裝置失敗。

此裝置找不到足夠的可用資源可供使用。 (12)

裝置找不到足夠的可用資源可供使用。

Windows無法驗證此裝置的資源。 (13)

Windows無法驗證裝置的資源。

在您重新開機電腦之前，此裝置無法正常運作。 (14)

裝置在電腦重新開機之前無法正常運作。

此裝置無法正常運作，因為可能有重新列舉問題。 (15)

裝置因可能重新列舉問題而無法正常運作。

Windows無法識別此裝置使用的所有資源。 (16)

Windows無法識別裝置使用的所有資源。

此裝置要求未知的資源類型。 (17)

裝置要求未知的資源類型。

重新安裝此裝置的驅動程式。 (18)

必須重新安裝設備磁碟機。

使用 VxD 載入器失敗。 (19)

您的登錄可能已損毀。 (20)

登錄可能已損毀。

系統失敗：請嘗試變更此裝置的驅動程式。如果無法運作，請參閱您的硬體檔。Windows正在移除此裝置。 (21)

系統失敗。 如果變更設備磁碟機無效，請參閱硬體檔。 Windows正在移除裝置。

此裝置已停用。 (22)

裝置已停用。

系統失敗：請嘗試變更此裝置的驅動程式。如果無法運作，請參閱您的硬體檔。 (23)

系統失敗。 如果變更設備磁碟機無效，請參閱硬體檔。

此裝置不存在、無法正常運作，或未安裝其所有驅動程式。 (24)

裝置不存在、無法正常運作，或未安裝其所有驅動程式。

Windows仍在設定此裝置。 (25)

Windows仍在設定裝置。

Windows仍在設定此裝置。 (26)

Windows仍在設定裝置。

此裝置沒有有效的記錄設定。 (27)

裝置沒有有效的記錄設定。

未安裝此裝置的驅動程式。 (28)

未安裝設備磁碟機。

此裝置已停用，因為裝置的韌體未提供所需的資源。 (29)

裝置已停用。 裝置韌體未提供所需的資源。

此裝置使用另一部裝置所使用的中斷要求 (IRQ) 資源。 (30)

裝置使用另一部裝置正在使用的 IRQ 資源。

此裝置無法正常運作，因為Windows無法載入此裝置所需的驅動程式。 (31)

裝置無法正常運作。 Windows無法載入必要的設備磁碟機。

ConfigManagerUserConfig

資料類型： 布林值

存取類型：唯讀

限定詞： 架構 (「Win32」)

如果 為 True，則裝置使用使用者定義的組態。

此屬性繼承自 CIM_LogicalDevice。

CreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： CIM_Key

要出現在實例建立時所使用之繼承鏈結中之第一個具體類別的名稱。 與 類別的其他索引鍵屬性搭配使用時，這個屬性允許唯一識別此類別及其子類別的所有實例。

此屬性繼承自 CIM_LogicalDevice。

說明

資料類型： 字串

存取類型：唯讀

限定詞： DisplayName (「Description」)

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DeviceID

資料類型： 字串

存取類型：唯讀

限定詞： Key、 Override (「DeviceId」) 、 MappingStrings (「WMI」)

記憶體陣列的唯一識別碼。

此屬性繼承自 CIM_LogicalDevice。

範例：「記憶體陣列 1」

ErrorCleared

資料類型： 布林值

存取類型：唯讀

如果 為 True，則現在會清除 LastErrorCode 中回報的錯誤。

此屬性繼承自 CIM_LogicalDevice。

ErrorDescription

資料類型： 字串

存取類型：唯讀

有關 LastErrorCode中所記錄之錯誤的詳細資訊，以及可採取之任何更正動作的相關資訊。

此屬性繼承自 CIM_LogicalDevice。

ErrorMethodology

資料類型： 字串

存取類型：唯讀

硬體所使用的錯誤檢查類型。

此屬性繼承自 CIM_StorageExtent。

檔

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|檔案系統函式GetVolumeInformation)

存取類型：唯讀

邏輯磁片上的檔案系統。

範例：「NTFS」

FreeSpace

資料類型： uint64

存取類型：唯讀

限定詞： 單位 (「bytes」)

邏輯磁片上可用的空間。

此屬性繼承自 CIM_LogicalDisk。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

InstallDate

資料類型： datetime

存取類型：唯讀

限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

存取類型：唯讀

安裝物件的日期和時間。 這個屬性不需要值來指出已安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

LastErrorCode

資料類型： uint32

存取類型：唯讀

邏輯裝置回報的最後一個錯誤碼。

此屬性繼承自 CIM_LogicalDevice。

MaximumComponentLength

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings (「Win32API|檔案系統函式GetVolumeInformation)

包含Windows磁片磁碟機所支援的檔案名元件長度上限。

範例：255

名稱

資料類型： 字串

存取類型：唯讀

限定詞： DisplayName (「Name」)

物件標籤。

此屬性繼承自 CIM_ManagedSystemElement。

NumberOfBlocks

資料類型： uint64

存取類型：唯讀

限定詞： MappingStrings (「MIB。IETF|HOST-RESOURCES-MIB.hrStorageSize「)

連續區塊的總數，每個區塊大小都包含在 BlockSize 屬性中，形成此儲存範圍。 儲存範圍的大小總計可以藉由將 BlockSize 屬性的值乘以此屬性的值來計算。 如果 BlockSize 的值是 1，則此屬性是儲存範圍的總大小。

此屬性繼承自 CIM_StorageExtent。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

PNPDeviceID

資料類型： 字串

存取類型：唯讀

限定詞： 架構 (「Win32」)

Windows 隨插即用邏輯裝置的裝置識別碼。

此屬性繼承自 CIM_LogicalDevice。

範例：「*PNP030b」

PowerManagementCapabilities

資料類型： uint16 陣列

存取類型：唯讀

邏輯裝置的特定電源相關功能陣列。

此屬性繼承自 CIM_LogicalDevice。

未知 (0)

不支援 (1)

停用 (2)

已啟用 (3)

電源管理功能目前已啟用，但確切的功能集不明或資訊無法使用。

自動輸入的省電模式 (4)

裝置可以根據使用量或其他準則來變更其電源狀態。

Power State Settable (5)

支援 SetPowerState 方法。 這個方法位於父 CIM_LogicalDevice 類別上，而且可以實作。 如需詳細資訊，請參閱 設計 Managed 物件格式 (MOF) 類別。

(6) 支援的電源迴圈

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 (Power Cycle) 。

支援的計時電源 (7)

支援的計時Power-On

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 (Power Cycle) ，並將 Time 設定為電源開啟的特定日期和時間或間隔。

PowerManagementSupported

資料類型： 布林值

存取類型：唯讀

如果 為 True，則裝置可以受電源管理 (可以進入暫停模式，依此類) 。 屬性不會指出電源管理功能目前已啟用，只有邏輯裝置能夠進行電源管理。

此屬性繼承自 CIM_LogicalDevice。

ProviderName

資料類型： 字串

存取類型：唯讀

限定詞：MappingStrings (「Win32API|Windows網路功能|WNetGetConnection「)

邏輯裝置的網路路徑名稱。

目的

資料類型： 字串

存取類型：唯讀

描述媒體及其使用方式的免費格式字串。

此屬性繼承自 CIM_StorageExtent。

QuotasDisabled

資料類型： 布林值

存取類型：唯讀

如果為 True，則不會為此磁片區啟用配額管理。

QuotasIncomplete

資料類型： 布林值

存取類型：唯讀

如果 為 True，則會使用配額管理，但已停用。 未完成是指在停用配額管理之後，檔案系統中留下的資訊。

QuotasRebuilding

資料類型： 布林值

存取類型：唯讀

如果 為 True，則表示檔案系統已設定配額管理。

SessionID

資料類型： 字串

存取類型：唯讀

限定詞： 金鑰

使用者會話的識別碼。 使用者可以使用本機登入或終端機會話來連線。

大小

資料類型： uint64

存取類型：唯讀

限定詞： 單位 (「bytes」)

邏輯磁片的大小。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

此屬性繼承自 CIM_LogicalDisk。

狀態

資料類型： 字串

存取類型：唯讀

限定詞： MaxLen (10) 、 DisplayName (「Status」)

物件的目前狀態。 您可以定義各種作業和非操作狀態。 作業狀態包括：「確定」、「已降級」和「預先失敗」 (元素，例如已啟用 SMART 的硬碟可能會正常運作，但預測近期) 失敗。 非操作狀態包括：「Error」、「Starting」、「Stopping」 和 「Service」。 服務狀態適用于系統管理工作，例如磁片的鏡像重新處理、重載使用者權限清單或其他系統管理工作。 並非所有這類工作都在線上，但 Managed 元素既不是「OK」，也不是處於其他狀態之一。

此屬性繼承自 CIM_ManagedSystemElement。

值如下：

OK (「OK」)

錯誤 (「錯誤」)

降級 (「已降級」)

未知 (「未知」)

預先失敗 (「預先失敗」)

開始 (「開始」)

停止 (「停止」)

服務 (「服務」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

沒有連絡人 (「沒有連絡人」)

Lost Comm (「Lost Comm」)

StatusInfo

資料類型： uint16

存取類型：唯讀

限定詞： MappingStrings (「MIF。DMTF|操作狀態|003.3「)

邏輯裝置的狀態。 如果此屬性不適用於邏輯裝置，應該使用 5 (不適用) 的值。

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已啟用 (3)

已停用 (4)

不適用 (5)

SupportsDiskQuotas

資料類型： 布林值

存取類型：唯讀

如果 為 True，則表示此網路磁碟機機對應的檔案系統支援磁片配額。

SupportsFileBasedCompression

資料類型： 布林值

存取類型：唯讀

限定詞： MappingStrings (「Win32API|檔案系統函式|GetVolumeInformation|FS_FILE_COMPRESSION「)

如果 為 True，邏輯磁碟分割支援以檔案為基礎的壓縮，例如 NTFS 的情況。 當Compressed屬性為True時，此屬性為False。

SystemCreationClassName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。CreationClassName「) ， CIM_Key

範圍電腦 CreationClassName 屬性的值。

此屬性繼承自 CIM_LogicalDevice。

SystemName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 (「CIM_System。名稱「) ， CIM_Key

範圍系統的名稱。

此屬性繼承自 CIM_LogicalDevice。

VolumeName

資料類型： 字串

存取類型：讀取/寫入

限定詞： MappingStrings (「Win32API|檔案系統函式GetVolumeInformation)

邏輯磁片的磁片區名稱。 這個屬性值最多可以有 32 個字元。

VolumeSerialNumber

資料類型： 字串

存取類型：唯讀

限定詞： MappingStrings (「Win32API|檔案系統函式GetVolumeInformation)

邏輯磁片的磁片區序號。 這個屬性值最多可以有 11 個字元。

此屬性繼承自 CIM_LogicalDevice。

範例：「A8C3-D032」

備註

針對這個類別傳回的實例如下所示，並假設使用者 A 正在列舉實例：

  • 提供者會在該電腦上尋找使用者 A 的登入會話：

    • 如果有一個 (，而且只有一個) 這類登入會話，提供者會傳回該會話的對應磁片磁碟機。
    • 如果電腦上有一個以上的使用者 A 會話，則不會傳回任何對應的磁片磁碟機實例 (，因為提供者沒有合理的方式來決定要使用哪一個會話) 。

  • 如果沒有執行中使用者 A 的會話，而且有本機登入的使用者 B：

    • 如果使用者 B 有單一會話，則提供者會模擬 A，並傳回使用者 B 的對應磁片磁碟機。此案例支援技術服務人員想要在本機登入使用者的實例。 不過，是否傳回實例取決於 主控台 系統管理工具中的本機安全性原則設定。 如果下列原則設定為 「Object Creator」，則即使 A 是 Administrators 群組的成員，也不會傳回任何對應的磁片磁碟機實例：

      「系統物件：系統管理員群組成員所建立之物件的預設擁有者。」

    • 同樣地，如果電腦上執行多個使用者 B 的會話，提供者就無法決定要使用哪一個會話。 在此情況下，不會傳回任何對應的磁片磁碟機實例。

如需使用 Win32_MappedLogicalDisk的詳細資訊，請參閱 如何判斷哪些磁片磁碟機對應至網路共用？

範例

下列 PowerShell 程式碼片段顯示對應的磁片磁碟機。

Get-WmiObject Win32_MappedLogicalDisk | Select Name, ProviderName, FileSystem, Size, FreeSpace | Format-Table

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
命名空間
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

CIM_LogicalDisk

電腦系統硬體類別

WMI 工作：磁片和檔案系統