Win32_Share 類別的 SetShareInfo 方法
SetShareInfoWMI 類別方法會設定共用資源的參數。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。
語法
uint32 SetShareInfo(
[in, optional] uint32 MaximumAllowed,
[in, optional] string Description,
[in, optional] Win32_SecurityDescriptor Access
);
參數
-
MaximumAllowed [in， optional]
-
限制允許同時使用此資源的使用者數目上限。
範例：10。 這是選擇性參數。
-
描述 [in， 選擇性]
-
選擇性批註，描述正在共用的資源。
-
存取 [in， 選擇性]
-
使用者層級許可權的安全性描述元。 安全性描述項包含資源之許可權、擁有者及存取功能的相關資訊。 如需詳細資訊，請參閱 Win32_SecurityDescriptor。
傳回值
傳回下列清單中所列的其中一個值或任何其他值，以指出錯誤。
-
成功 (0)
-
拒絕存取 (2)
-
未知的失敗 (8)
-
不正確名稱 (9)
-
不正確層級 (10)
-
不正確參數 (21)
-
重複的共用 (22)
-
重新導向路徑 (23)
-
未知的裝置或目錄 (24)
-
找不到 net name (25)
-
其他 (26 4294967295)
備註
SetShareInfo 方法是動態物件方法，用於發生這個類別。
只有系統管理員或帳戶操作員本機群組的成員或具有通訊、列印或伺服器操作員群組成員資格的成員可以成功執行 SetShareInfo。 列印運算子只能設定印表機佇列。 通訊操作員只能設定通訊裝置佇列。
範例
下列 PowerShell 範例會更新 newShare 共用的名稱。
$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|