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 |
|
| DLL |
|
另請參閱