使用 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_TYPE | 0 | 允許存取型別 ACE |
| GENERIC_READ | 1179817 (0x1200A9) | 讀取/列出/讀取屬性/權限 |
| GENERIC_WRITE | 1245631 (0x13013F) | 寫入/新增/刪除/屬性/權限 |
| GENERIC_ALL | 2032127 (0x1F01FF) | 完全控制 |
| OBJECT_INHERIT_ACE | 16 (0x10) | 子物件繼承 |
| CONTAINER_INHERIT_ACE | 2 (0x2) | 子容器繼承 |
| INHERIT_ONLY_ACE | 8 (0x8) | 僅繼承,不套用於本物件 |
| SE_DACL_PROTECTED | &H1000 | 阻止繼承 (保護模式) |
| SE_DACL_AUTO_INHERITED | &H400 | 自動繼承已生效 |
wbemtest 驗證。icacls.exe 或 PowerShell Set-Acl,效能與除錯較佳。掌握 WMI 操作 NTFS ACL,可在自動化部署腳本中精確控制檔案系統權限,無需依賴外部工具。