Get-Acl 幫助信息

如下說明是翻譯PowerShell中: help Get-Acl 產生的幫助信息.
譯者: Edengundam(馬濤)
 
Get-Acl
 
摘要
獲取資源的安全描述符, 例如文件或注冊表鍵.
 
語法
Get-Acl [[-path] <string[]>] [-filter <string>] [-include <string[]>] [-exclude <string[]>] [-audit] [<CommonParameters>]
 
詳細描述
Get-Acl cmdlet取得表示文件或資源的安全描述符. 安全描述符包含了資源的訪問控制列表(ACLs). ACL指定了用戶和用戶組對資源具有的訪問權限.
 
參數
 
-path <string[]>
指定資源的路徑. Get-Acl取得路徑指定的資源的安全描述符. 允許使用通配符. 如果你省略了參數Path, Get-Acl取得當前目錄的安全描述符.
 
參數名稱("-Path")為

$False$

選項.
 
強制參數?
false
參數位置?
1
默認值 cm; BORDER-LEFT: medium none; WIDTH: 206.45pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="275">
 
允許從管道綁定輸入?
true (根據值, 根據屬性名)
允許通配符擴展?
true
 
-filter <string>
指定特定provider格式或語言的過濾器.此參數值用於限定Path10pt">參數. 過濾器的語法取決於provider(是否支持通配符也依賴provider). 過濾器相比其他參數更加有效, 主要因為provider取值時候使用過濾器, 而不是等到provider將所有內容返回後, 由Windows PowerShell 過濾對象.
 
強制參數?
false
參數位置?

named
默認值
 
允許從管道綁定輸入?
false
允許通配符擴展?
false
 
-include <string[]>
取得指定的項. 此參數值用於限定Path參數. 輸入一個路徑元素或模式, 例如"*.txt"(此參數允許通配符).
 
強制參數?
false text 1pt solid" valign="top" width="275">
參數位置?
named
默認值
 
允許從管道綁定輸入?
false 275">
允許通配符擴展?
true
 
-exclude <string[]>
忽略指定的項. 此參數值用於限定Path參數. 輸入一個路徑元素或模式, 例如"*.txt"(此參數允許通配符).
 
強制參數?
false

0cm; BORDER-LEFT: windowtext 1pt solid; WIDTH: 206.1pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="275">
參數位置?
named
默認值
 
允許從管道綁定輸入?
false 文章整理:

id; WIDTH: 206.1pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="275">
允許通配符擴展?
true
 
-audit <SwitchParameter>
從系統訪問控制列表(SACL)中取得安全描述符的審計數據.
 
強制參數?
false
參數位置?

ADDING-RIGHT: 5.4pt; BORDER-TOP: medium none; PADDING-LEFT: 5.4pt; PADDING-BOTTOM: 0cm; BORDER-LEFT: medium none; WIDTH: 200.7pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="268">
named
默認值
False
允許從管道綁定輸入?
false
允許通配符擴展? 文章整理:; PADDING-RIGHT: 5.4pt; BORDER-TOP: medium none; PADDING-LEFT: 5.4pt; PADDING-BOTTOM: 0cm; BORDER-LEFT: medium none; WIDTH: 200.7pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="268">
false
 
<公共參數>
此命令支持公共參數: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 輸入, "get-help about_commonparameters".
 
輸入類型
String
 
返回類型
System.Security.AccessControl.DirectorySecurity對象
 
注意
 
更多信息, 輸入"Get-Help Get-Acl -detailed". 需要技術信息, 輸入"Get-Help Get-Acl -full".
 
如果需要為該命令提供多個參數, 請使用逗號進行分隔. 例如, "<parameter-name> <value1>, <value2>".
 
默認情況下, Get-Acl顯示資源的Windows PowerShell路徑(&lt;provider>::<resource-path>), 資源的屬主以及訪問權限(資源的自由訪問控制列表(DACL)中的訪問控制項的列表或數組). 資源的屬主控制DACL列表.
 
當你將結果格式化為列表時("get-acl | format-list"), 除了路徑, 屬主, 訪問列表外, Windows PowerShell還將顯示如下域:
 
·         Group: 屬主的安全組.
·         Audit:  系統訪問控制列表(SACL)中的列表(數組). SACL指定了Windows產生的審計記錄的嘗試訪問的類型.
·         Sddl: 資源的安全描述以安全描述符定義語言的文本字符串格式顯示. Windows PowerShell 使用安全描述的GetSddlForm方法取得此數據.

an>
 
因為文件系統和注冊表提供程序支持Get-Acl, 你可以使用Get-Acl查看文件系統上對象(例如: 目錄和文件)的ACL和注冊表對象(例如: 注冊表項和條目).
 
例1
 
C:\PS>get-acl C:\Windows
 
此命令取得C:Windows目錄的安全描述符.
 
例2
 
C:\PS>get-acl C:\Windows\k*.log | select-object PSPath, Sddl | format-list
 
此命令取得C:\Windows目錄中所有以"k"開頭的日志文件的路徑和SDDL字符串.
 
命令使用Get-Acl取得表示每個日志文件的安全描述符. 它將結果發送給Select-Object cmdlet, 後者只選擇PSPath和SDDL域的值. ="FONT-SIZE: 10pt">接下來, 它將結果發送給Format-List cmdlet將結果顯示為列表形式. 因為數值過長將會在表格中被截斷, 因此列表經常在Windows Powershell中使用.
 
對於系統管理員來說SDDL的值非常有價值, 這是因為這個簡單的字符串包含了安全描述符中的所有的信息. 類似的是它們能夠被容易的傳遞和保存, 必要的時候還可以被分析.
 
例3
 
C:\PS>get-ACL c:/Windows/k*.log -Audit | foreach-object { $_.Audit.Count }
 
此命令取得目錄C:\Windows中, 以"k"開頭的日志文件的文件描述符. 它使用了Audit參數從安全描述符中的SACL中取得審計記錄. 接下來它使用ForEach-Object參數, 來計算每個文件關聯的審計記錄的數量. 結果是表示每個日志文件的審核記錄數量的數值列表.
 
例

n >4
 
C:\PS>get-acl -path hklm:\system\currentcontrolset\control | format-list
 
此命令使用Get-Acl取得注冊表中Control子項(HKLM\SYSTEM\CurrentControlSet\Control)的安全描述符.
 
參數Path指定了Control子項的路徑. 管道運算符(|)將Get-Acl取得的安全描述符傳給Format-List命令, 後者為了方便閱讀, 將安全描述的屬性格式化成一個列表.
 
相關鏈接
Set-Acl
about_namespace