如下說明是翻譯PowerShell中: help Get-ChildItem 產生的幫助信息.
譯者: Edengundam(馬濤)
Get-ChildItem
大綱取得一個或多個指定位置中的項和子項.
語法Get-ChildItem [[-path] <string[]>] [[-filter] <string>] [-include <string[]>] [-exclude <string[]>] [-name] [-recurse] [-force] [<CommonParameters>]
Get-ChildItem [-literalPath] <string[]> [[-filter] <string>] [-include <string[]>] [-exclude <string[]>] [-name] [-recurse] [-force] [<CommonParameters>]
詳細描述Get-Childitem cmdlet取得一個或多個指定位置中的項和子項. 如果該項為容器, 命令取得容器中的項(稱為子項). 你可以使用參數Recurse取得子容器中的所有項. 位置可以是文件系統位置, 例如:目錄, 或者是其他提供程序公開的位置,
$False$
例如: 注冊表配置單元或證書存儲區.
參數
-path <string[]>
指定一個或多個位置的路徑. 允許使用通配符. 默認位置是當前目錄(.).
強制參數?
false
參數位置?
1
默認值
<注意: 如果不指定, 使用當前位置>
允許從管道綁定輸入?
true (根據值, 根據屬性名)
10pt">允許通配符擴展?
true
-include <string[]>只檢索指定項. 此參數值限定參數Path. 輸入一個路徑元素或者模式, 例如"*.txt". 允許使用通配符.
只有在命令包含參數Recurse或者路徑執行目錄中的內容(例如: such as C:\Windows\*, 這裡的通配制定了Windows目錄C:\中的內容)時才有效.
強制參數?
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
參數位置?
named
默認值
允許從管道綁定輸入?
0cm; BORDER-LEFT: medium none; WIDTH: 200.7pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="268">
false
允許通配符擴展?
true
-exclude <string[]>忽略指定項. 此參數值限定參數Path. 輸入一個路徑元素或者模型, 例如"*.txt". 允許使用通配符.
對於此命令來說, 此參數可能無法正常工作.
強制參數?
false
參數位置?
named
默認值
允許從管道綁定輸入?
false
允許通配符擴展?
true
-filter <string>指定特定provider格式或語言的過濾器.此參數值用於限定Path參數. 過濾器的語法取決於provider(是否支持通配符也依賴provider). 過濾器相比其他參數更加有效, 主要因為provider取值時候使用過濾器, 而不是等到provider將所有內容返回後,由Windows PowerShell 過濾對象.
強制參數?
false
參數位置?
2
默認值 允許從管道綁定輸入?
false
允許通配符擴展?
true
-name <SwitchParameter>只取得位置上項的名稱. 如果你通過管道將此命令輸出發送給另一個命令, 只有項的名稱會被發送.
LEFT: 0.5pt; WIDTH: 406.8pt; BORDER-COLLAPSE: collapse" cellspacing="0" cellpadding="0" width="542" border="0">
強制參數?
false
參數位置?
named
默認值 windowtext 1pt solid" valign="top" width="268">
False
允許從管道綁定輸入?
false
允許通配符擴展?
false
-recurse <SwitchParameter>在指定位置及其所有子項子項中檢索.
只有在路徑指向容器, 並且其中具有子項時(例如: C:\Windows或C:\Windows\*,並且路徑不能指向沒有子項的項, 例如: C:\Windows\*.exe), 才發生遞歸.
強制參數?
false
參數位置?
named dth="275">
默認值
False
允許從管道綁定輸入?
false
允許通配符擴展?
false
-force <SwitchParameter>在不破壞安全性的前提下, 能夠避免影響命令成功執行的限制條件,例如: Force參數能夠覆蓋具有只讀屬性的文件或創建路徑中的必要成分, 但是不會改變人和文件的權限.
強制參數?
false
參數位置?
named op" width="275">
默認值
False
允許從管道綁定輸入?
false
允許通配符擴展?
false
-codeSigningCert <SwitchParameter>僅檢索具有代碼簽名頒發機構的證書. 此參數只有在使用ZE: 10pt">Windows PowerShell證書提供程序時才有效. 更多的信息, 鍵入"get-help about_provider"和"get-help about_signing".
強制參數?
false
參數位置?
named e6e6; PADDING-BOTTOM: 0cm; BORDER-LEFT: windowtext 1pt solid; WIDTH: 206.1pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="275">
默認值
允許從管道綁定輸入?
false
允許通配符擴展?
false
-literalPath <string[]>指定一個或多個位置的路徑FONT-SIZE: 10pt">. 與Path不同, LiteralPath的值被直接使用, 不會對任何通配符進行解釋. 如果路徑中包含了轉義字符, 需要將路徑用單引號保護. 單引號指示Windows PowerShell不對字符串中的轉義字符進行處理.
強制參數?
true
參數位置? m; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="276">
1
默認值
允許從管道綁定輸入?
true (根據屬性名)
允許通配符擴展?
medium none; WIDTH: 206.9pt; PADDING-TOP: 0cm; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="276">
false
<公共參數>此命令支持公共參數: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 輸入, "get-help
about_commonparameters".
輸入類型String
注意 更多信息, 輸入"Get-Help Get-ChildItem -detailed". 需要技術信息, 輸入"Get-Help Get-ChildItem -full".
Get-Childitem默認不取得隱藏項. 取得隱藏項, 使用-Force.
如果需要為該命令提供多個參數, 請使用逗號進行分隔. 例如, "<parameter-name> <value1>, <value2>".
你可以使用Get-ChildItem的內建別名"ls", "dir",and "gci".需要更多信息, 查看
About_Alias.
例1 C:\PS>get-childitem
此命令檢索當前位置的子項. 如果當前位置是文件系統目錄, 此命令檢索當前目錄中的文件和子目錄. 如果項中不包含子項, 此命令不顯示任何信息, 直接返回命令提示符.
默認顯示列出了模式(屬性), 最後寫入時間, 文件大小(長度)和文件名稱. 模式的合法值為: d (目錄), a (存檔), r (只讀), h (隱藏)和s (系統).
例2 C:\PS>get-childitem . -Include *.txt -Recurse
此命令在當前目錄及其子目錄中檢索所有的t">.txt文件. 點(".")表示當前目錄, 參數Include指定了文件擴展名. 參數Recurse指示Windows PowerShell遞歸地檢索對象, 指出命令的目標是指定目錄及其內容.
例3 C:\PS>get-childitem c:\Windows\logs\* -include *.txt -exclude A*
此命令列出Logs子目錄中除了文件名以A開頭的所有.txt文件. 它適用了通配符(*)指示Logs子目錄中的內容, 而不是目錄容器. 由於命令沒有包含參數Recurse, Get-Childitem不會自動將目錄內容包含進來; 如果需要, 需要顯示指定它.
例4 C:\PS>get-childitem registry::hklm\software
此命令檢索本地計算機注冊表中HKEY_LOCAL_MacHINE\SOFTWARE項的所有注冊表項.
例5 C:\PS>get-childitem -name
此命令只檢索當前目錄中項的名稱.
例6 C:\PS>get-childitem cert:\. -recurse -codesigningcert
此命令獲取證書存儲區中具有代碼簽名頒發機構的所有證書. 此命令使用了Get-Childitem cmdlet. 路徑指定為Windows PowerShell證書提供程序公開的Cert:驅動器. 反斜線(\)符號指定了證書存儲區的一個子目錄, 點(.)表示當前目錄(也就是證書存儲區的根目錄). 參數Recurse指出遞歸查詢, 參數CodeSigningCertificate指出只獲取具有代碼簽名頒發機構的所有證書.
例7 C:\PS>get-childitem * -Include *.exe
此命令取得當前目錄中所有文件擴展名為".exe"的項. 通配符(*)<span >表示當前目錄(而不是容器)的內容. 當使用了Include參數而不指定Recurse參數時, 路徑必須指向內容, 而不是容器.
相關鏈接Get-ItemGet-AliasGet-LocationGet-Processabout_namespace
