Win32_Share 類別

Win32_Share 類別代表執行 Windows 之電腦系統上的共享資源。 這可能是磁碟驅動器、印表機、進程間通訊或其他可共享裝置。 如需擷取 WMI 類別的詳細資訊，請參閱 擷取類別。

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

語法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  uint32   AccessMask;
  boolean  AllowMaximum;
  uint32   MaximumAllowed;
  string   Name;
  string   Path;
  uint32   Type;
};

成員

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

• 方法
• 屬性

方法

Win32_Share 類別具有這些方法。

方法	描述
建立	起始伺服器資源分享的類別方法。
刪除	類別方法，從伺服器的共用資源清單中刪除共享名稱，並中斷與共用資源的連線。
GetAccessMask	傳回代表實例傳回之使用者或群組所持有之共用的訪問許可權。 您應該使用這個方法取代一律為 NULL 的 AccessMask 屬性。
SetShareInfo	設定共用資源的參數的類別方法。

 

屬性

Win32_Share類別具有這些屬性。

AccessMask

數據類型： uint32

存取類型：唯讀

限定符： 已淘汰

這個屬性已經過時，不再使用。 請改用 Win32_Share.GetAccessMask 方法。 AccessMask 屬性的值是由 WMI 設定為 null。 如需建立共享時設定存取權的詳細資訊，請參閱 Create 方法。

AllowMaximum

數據類型： 布爾值

存取類型：唯讀

限定符：MappingStrings （“Win32API|網路管理結構|SHARE_INFO_502|shi502_max_uses“）

此資源的並行用戶數目已受到限制。 如果為 True，則會忽略 MaximumAllowed 屬性中的值。

標題

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）， DisplayName （“Caption”）

對象的簡短文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

說明

數據類型： 字串

存取類型：唯讀

限定符： DisplayName （“Description”）

物件的文字描述。

此屬性繼承自 CIM_ManagedSystemElement。

InstallDate

數據類型： datetime

存取類型：唯讀

限定符： MappingStrings （“MIF.DMTF|ComponentID|001.5“）， DisplayName （”安裝日期“）

指出物件安裝的時間。 缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

MaximumAllowed

數據類型： uint32

存取類型：唯讀

限定符：MappingStrings （“Win32API|網路管理結構|SHARE_INFO_502|shi502_max_uses“）

限制允許同時使用此資源的用戶數目上限。 只有在AllowMaximum屬性設定為 FALSE 時，這個值才有效。

名稱

數據類型： 字串

存取類型：唯讀

限定符：索引鍵、覆寫 （“Name”），MappingStrings （“Win32API|網路管理結構|SHARE_INFO_1|shi1_netname“）

指定給執行 Windows 之電腦系統上設定為共用之路徑的別名。

Windows 2008 範例：“\SERVER01\public” - Windows Server 2008 要求您將 UNC 放在名稱中。

路徑

數據類型： 字串

存取類型：唯讀

限定符： MappingStrings （“Win32API|網路管理結構|SHARE_INFO_502|shi502_path“）

Windows 共用的本機路徑。

範例：“C：\Program Files”

狀態

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （10）， DisplayName （“Status”）

表示物件目前狀態的字串。 您可以定義操作和非操作狀態。 作業狀態可以包含 「確定」、「已降級」和「預先失敗」。 「預先失敗」表示元素正常運作，但正在預測失敗（例如，已啟用SMART的硬碟驅動器）。

非作業狀態可能包括「錯誤」、「啟動」、「停止」和「服務」。 「服務」可以在磁碟鏡像重新Silvering、重載用戶權力清單或其他系統管理工作期間套用。 並非所有這類工作都在在線，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態中。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 （“OK”）

錯誤 （「錯誤」

已降級 （「已降級」

未知 （“未知”）

Pred Fail （“Pred Fail”）

啟動 （“開始”）

停止 （“停止”）

服務 （“Service”）

壓力（“壓力”）

NonRecover （“NonRecover”）

無連絡人 （“無聯繫人”）

Lost Comm （“Lost Comm”）

類型

數據類型： uint32

存取類型：唯讀

限定符： MappingStrings （“Win32API|網路管理結構|SHARE_INFO_502|shi502_type“）

要共用的資源類型。 類型包括：磁碟驅動器、列印佇列、進程間通訊（IPC）和一般裝置。

磁碟驅動器 （0）

列印佇列 （1）

裝置 （2）

IPC （3）

磁碟驅動器 管理員 （2147483648）

列印佇列 管理員 （2147483649）

裝置 管理員 （2147483650）

IPC 管理員 （2147483651）

備註

Win32_Share類別衍生自 CIM_LogicalElement。

此類別中的 Create 方法是靜態方法。 Delete、GetAccessMask 和 SetShareInfo 方法都是實例方法。

根據您的安全性許可權，您可能無法擷取此類別的所有屬性。 例如， AllowMaximum、 MaximumAllowed、 Path 和 Type 屬性可能會傳回 Null。 一般而言，Power Users 和 管理員 istrators 將能夠擷取所有屬性值。

範例

下列 PowerShell 範例會顯示本機系統上的共用。

$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto

或者，如果您想要更精確地篩選，您可以使用下列 PowerShell 代碼段：

gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"

下列 VBScript 範例會顯示本機系統上的共用。

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")


For Each objItem in colItems 
 Wscript.Echo "Name: " & objItem.Name
 Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next

需求

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

另請參閱

CIM_LogicalElement

作業系統類別

WMI 工作：檔案和資料夾