取得位於指定位置的項目。

語法

Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Item [-路徑] <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

-路徑 <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* 開頭的項目。這個命令只有在路徑包括萬用字元 (*) 以指定項目內容時才能作用。






請參閱




目錄