萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

VBScript 透過 WMI 修改檔案/資料夾 NTFS 權限:完整函式 AddPermission

使用 WMI Win32_LogicalFileSecuritySetting、Win32_ACE、Win32_Trustee、Win32_SID 等類別,以 VBScript 程式化新增/修改 NTFS ACL 權限。本文提供可直接呼叫的 AddPermission 函式完整代碼。

函式簽名

Function AddPermission(strUser, strPath, strAccess, blInherit)
' 回傳: 0=成功, 1=帳號不存在, 2=路徑不存在
' strUser: 使用者/群組名稱 (如 "Guests", "Everyone")
' strPath: 檔案或資料夾完整路徑
' strAccess: 權限字串 R=讀取, C=讀寫, F=完全控制
' blInherit: True=繼承父目錄權限, False=不繼承

完整實作代碼

Function AddPermission(strUser, strPath, strAccess, blInherit)
  Dim objWMI, fso, colUsers, objUser, strSID, objSID, objTrustee, objNewACE
  Dim objFileSecSetting, objSD, objOldDacl, objNewDacl, blAutoInherit, pathType
  
  Set objWMI = GetObject("winmgmts:\\.\root\cimv2")
  Set fso = CreateObject("Scripting.FileSystemObject")
  
  ' 1. 解析使用者 SID
  Set colUsers = objWMI.ExecQuery("SELECT * FROM Win32_Account WHERE Name='" & strUser & "'")
  If colUsers.Count = 0 Then
    AddPermission = 1: Exit Function
  End If
  For Each objUser In colUsers: strSID = objUser.SID: Next
  Set objSID = objWMI.Get("Win32_SID.SID='" & strSID & "'")
  
  ' 2. 確認路徑存在與類型
  pathType = ""
  If fso.FileExists(strPath) Then pathType = "FILE"
  If fso.FolderExists(strPath) Then pathType = "FOLDER"
  If pathType = "" Then AddPermission = 2: Exit Function
  
  ' 3. 建立 Trustee
  Set objTrustee = objWMI.Get("Win32_Trustee").SpawnInstance_()
  objTrustee.Domain = objSID.ReferencedDomainName
  objTrustee.Name = objSID.AccountName
  objTrustee.SID = objSID.BinaryRepresentation
  objTrustee.SidLength = objSID.SidLength
  objTrustee.SIDString = objSID.Sid
  
  ' 4. 建立 ACE (存取控制項目)
  Set objNewACE = objWMI.Get("Win32_ACE").SpawnInstance_()
  objNewACE.Trustee = objTrustee
  objNewACE.AceType = 0 ' ACCESS_ALLOWED_ACE_TYPE
  
  ' 權限遮罩
  If InStr(UCase(strAccess), "R") > 0 Then objNewACE.AccessMask = 1179817   ' GENERIC_READ
  If InStr(UCase(strAccess), "C") > 0 Then objNewACE.AccessMask = 1245631   ' GENERIC_WRITE + READ
  If InStr(UCase(strAccess), "F") > 0 Then objNewACE.AccessMask = 2032127   ' GENERIC_ALL
  
  ' 繼承旗標
  If pathType = "FILE" And blInherit Then objNewACE.AceFlags = 16  ' OBJECT_INHERIT_ACE
  If pathType = "FILE" And Not blInherit Then objNewACE.AceFlags = 0
  If pathType = "FOLDER" And blInherit Then objNewACE.AceFlags = 19 ' CONTAINER_INHERIT | OBJECT_INHERIT | INHERIT_ONLY
  If pathType = "FOLDER" And Not blInherit Then objNewACE.AceFlags = 3 ' CONTAINER_INHERIT | OBJECT_INHERIT
  
  ' 5. 取得現有 SD (安全描述子)
  Set objFileSecSetting = objWMI.Get("Win32_LogicalFileSecuritySetting.Path='" & strPath & "'")
  objFileSecSetting.GetSecurityDescriptor objSD
  
  ' 6. 控制旗標處理
  blAutoInherit = True
  If (objSD.ControlFlags And &H400) = 0 Then ' SE_DACL_AUTO_INHERITED
    blAutoInherit = False
    objSD.ControlFlags = objSD.ControlFlags Or &H400
  End If
  
  If blInherit Then
    objSD.ControlFlags = objSD.ControlFlags And &HEFFF ' 移除 SE_DACL_PROTECTED
  Else
    objSD.ControlFlags = objSD.ControlFlags Or &H1400  ' SE_DACL_PROTECTED | SE_DACL_AUTO_INHERITED
  End If
  
  ' 7. 合併舊 DACL 與新 ACE
  objOldDacl = objSD.Dacl
  ReDim objNewDacl(0)
  Set objNewDacl(0) = objNewACE
  
  If IsArray(objOldDacl) Then
    For Each objACE In objOldDacl
      ' 保留規則: 非自動繼承+要求繼承、或已繼承ACE、或同一用戶(避免重複)
      If Not ( (Not blAutoInherit And blInherit) Or _
               (objACE.AceFlags And 16) > 0 And blInherit Or _
               LCase(objACE.Trustee.Name) = LCase(strUser) ) Then
        ReDim Preserve objNewDacl(UBound(objNewDacl) + 1)
        Set objNewDacl(UBound(objNewDacl)) = objACE
      End If
    Next
  End If
  
  objSD.Dacl = objNewDacl
  
  ' 8. 套用安全描述子
  Dim retVal
  retVal = objFileSecSetting.SetSecurityDescriptor(objSD)
  If retVal = 0 Then AddPermission = 0 Else AddPermission = retVal
End Function

呼叫範例

' 給 Guests 群組讀取權限,繼承父目錄
RetVal = AddPermission("Guests", "D:\Data\Shared", "R", True)

' 給 Administrators 完全控制,不繼承 (保護模式)
RetVal = AddPermission("Administrators", "D:\Data\Private", "F", False)

Select Case RetVal
  Case 0: WScript.Echo "權限設定成功"
  Case 1: WScript.Echo "帳號不存在"
  Case 2: WScript.Echo "路徑不存在"
  Case Else: WScript.Echo "WMI 錯誤碼: " & RetVal
End Select

關鍵常數對照

常數值含義
ACCESS_ALLOWED_ACE_TYPE0允許存取型別 ACE
GENERIC_READ1179817 (0x1200A9)讀取/列出/讀取屬性/權限
GENERIC_WRITE1245631 (0x13013F)寫入/新增/刪除/屬性/權限
GENERIC_ALL2032127 (0x1F01FF)完全控制
OBJECT_INHERIT_ACE16 (0x10)子物件繼承
CONTAINER_INHERIT_ACE2 (0x2)子容器繼承
INHERIT_ONLY_ACE8 (0x8)僅繼承,不套用於本物件
SE_DACL_PROTECTED&H1000阻止繼承 (保護模式)
SE_DACL_AUTO_INHERITED&H400自動繼承已生效

注意事項

  • 需**管理員權限**執行 (UAC 提升)。
  • WMI 安全性操作較底層,錯誤碼非標準 Win32 錯誤,建議搭配 wbemtest 驗證。
  • 大量設定權限建議改用 icacls.exe 或 PowerShell Set-Acl,效能與除錯較佳。
  • 此函式**新增** ACE,不移除既有 ACE (除非同用戶/繼承邏輯判定)。

掌握 WMI 操作 NTFS ACL,可在自動化部署腳本中精確控制檔案系統權限,無需依賴外部工具。

copyright © 萬盛學電腦網 all rights reserved