Get-Item
取得位於指定位置的項目。
語法
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
描述
Get-Item Cmdlet 會取得位於指定之位置的項目。除非您使用萬用字元 (*) 要求該項目的所有內容，否則它並不會取得該位置上的項目內容。
Windows PowerShell 提供者可以利用 Get-Item Cmdlet，供您瀏覽不同類型的資料存放區。
參數
-Credential <PSCredential>
指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。
請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"，或是輸入 PSCredential 物件，例如由 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，將會提示您提供密碼。
所有隨 Windows PowerShell 安裝的提供者都不支援此參數。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
true (ByPropertyName) |
接受萬用字元? |
false |
-Exclude <string[]>
忽略指定的項目。此參數的值用於限定 Path 參數。輸入路徑元素或模式，例如 "*.txt"。允許使用萬用字元。
只有當命令包含項目的內容 (例如 C:\Windows\*，因為其中的萬用字元指定了 C:\Windows 目錄的內容) 時，Exclude 參數才會生效。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Filter <string>
指定以提供者的格式或語言表示的篩選器。此參數的值用於限定 Path 參數。篩選器的語法 (包括萬用字元的用法) 依提供者而定。篩選器比其他參數更有效率，因為提供者會在擷取物件時套用篩選器，而非等到 Windows PowerShell 擷取物件後才進行篩選。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Force
允許此 Cmdlet 取得無法以其他方式存取的項目，例如隱藏項目。實作因提供者而異。如需詳細資訊，請參閱 about_Providers。即便使用 Force 參數，此 Cmdlet 也無法覆寫安全性限制。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-Include <string[]>
只擷取指定的項目。此參數的值用於限定 Path 參數。輸入路徑元素或模式，例如 "*.txt"。允許使用萬用字元。
只有當命令包含項目的內容 (例如 C:\Windows\*，因為其中的萬用字元指定了 C:\Windows 目錄的內容) 時，Include 參數才會生效。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
-LiteralPath <string[]>
指定項目的路徑。LiteralPath 與 Path 不同，係取用實際輸入的內容做為參數值。任何字元均不被解譯成萬用字元。如果路徑中包含逸出字元，請將其置於單引號內。單引號係告訴 Windows PowerShell 不要將任何字元解譯成逸出序列。
必要? |
true |
位置? |
1 |
預設值 |
|
接受管線輸入? |
true (ByPropertyName) |
接受萬用字元? |
false |
-Path <string[]>
指定項目路徑。Get-Item 會取得位於指定位置的項目。允許使用萬用字元。此參數為必要參數，但參數名稱 ("Path") 則為選擇性。
使用句點 (.) 指定目前的位置。使用萬用字元 (*) 可以指定位於目前位置的所有項目。
必要? |
true |
位置? |
1 |
預設值 |
|
接受管線輸入? |
true (ByValue, ByPropertyName) |
接受萬用字元? |
false |
-UseTransaction
將命令加入現用交易中。此參數只有當交易進行中時才有效。如需詳細資訊，請參閱 about_Transactions。
必要? |
false |
位置? |
named |
預設值 |
|
接受管線輸入? |
false |
接受萬用字元? |
false |
<CommonParameters>
這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.
輸入和輸出
輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。
輸入 |
System.String 您可以經由管道將包含路徑的字串輸出至 Get-Item。 |
輸出 |
Object Get-Item 會傳回其取得的物件。該類型是由路徑中的物件類型所決定。 |
附註
您也可以利用內建的別名 "gi" 來參照 Get-Item。如需詳細資訊，請參閱 about_Aliases。
Get-Item 沒有 Recurse 參數，因為它只會取得項目，而非項目的內容。若要遞迴取得項目的內容，請使用 Get-ChildItem。
若要瀏覽登錄，請使用 Get-Item 取得登錄機碼，並用 Get-ItemProperty 取得登錄值和資料。這些登錄值就是登錄機碼的屬性。
Get-Item Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PsProvider"。如需詳細資訊，請參閱 about_Providers。
範例 1
C:\PS>get-item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
描述
-----------
這個命令會取得目前的目錄。點 (.) 代表位於目前位置的項目 (而非其內容)。
範例 2
C:\PS>get-item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
描述
-----------
這個命令會取得目前目錄中的所有項目。萬用字元 (*) 代表目前項目的所有內容。
範例 3
C:\PS>get-item C:\
描述
-----------
這個命令會取得 C: 磁碟機目前的目錄。所擷取的物件僅代表此目錄，而非其內容。
範例 4
C:\PS>get-item C:\*
描述
-----------
這個命令會取得位在 C: 磁碟機中的項目。萬用字元 (*) 代表容器中的所有項目，而不只是代表容器。
在 Windows PowerShell 中，使用單一星號 (*) 取得內容，而不是使用傳統的 "*.*"。格式會逐字解譯，所以 "*.*" 不會擷取沒有包含 (.) 的目錄或是檔案名稱。
範例 5
C:\PS>(get-item C:\Windows).LastAccessTime
描述
-----------
這個命令會取得 C:\Windows 目錄的 LastAccessTime 屬性。LastAccessTime 只是其中一種檔案系統目錄屬性。若要查看目錄的所有屬性，請輸入 "(Get-Item <directory-name>) | Get-Member"。
範例 6
C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*
描述
-----------
這個命令會顯示 Microsoft.PowerShell 登錄機碼的內容。您可以搭配 Windows PowerShell 登錄提供者使用 Get-Item 以取得登錄機碼和子機碼，不過，您必須使用 Get-ItemProperty 取得登錄值和資料。
範例 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w*
描述
-----------
這個命令會取得在 Windows 目錄中名稱包含點 (.) 但不是以 w* 開頭的項目。這個命令只有在路徑包括萬用字元 (*) 以指定項目內容時才能作用。
請參閱
概念
about_Providers
Clear-Item
Copy-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item