取得指定項目的屬性。

語法

Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-ItemProperty [-路徑] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

描述

Get-ItemProperty Cmdlet 取得指定項目的屬性。例如，您可以使用 Get-ItemProperty 取得檔案物件的 LastAccessTime 屬性值。您也可以使用 Get-ItemProperty 檢視登錄項目與它們的值。

參數

-Credential <PSCredential>

指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。

請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"，或是輸入 PSCredential 物件，例如由 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，將會提示您提供密碼。

所有隨 Windows PowerShell 安裝的提供者都不支援此參數。

必要?

false

位置?

named

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Exclude <string[]>

忽略指定的項目。允許使用萬用字元。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Filter <string>

指定以提供者的格式或語言表示的篩選器。此參數的值用於限定 Path 參數。篩選器的語法 (包括萬用字元的用法) 依提供者而定。篩選器比其他參數更有效率，因為提供者會在擷取物件時套用篩選器，而非等到 Windows PowerShell 擷取物件後才進行篩選。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Include <string[]>

包含指定的項目。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-LiteralPath <string[]>

指定項目屬性的路徑。LiteralPath 係取用實際輸入的內容做為參數值。任何字元均不被解譯成萬用字元。如果路徑中包含逸出字元，請將其置於單引號內。單引號係告訴 Windows PowerShell 不要將任何字元解譯成逸出序列。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

false

-Name <string[]>

指定要擷取的一個或多個屬性的名稱。

必要?

false

位置?

2

預設值

接受管線輸入?

false

接受萬用字元?

false

-路徑 <string[]>

指定指向一個或多個項目的路徑。

必要?

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-ItemProperty。

輸出

Object

Get-ItemProperty 會針對它所取得的每一個項目屬性傳回物件。此物件類型取決於擷取的物件。

附註

Get-ItemProperty Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PSProvider"。如需詳細資訊，請參閱 about_Providers。

範例 1

C:\PS>get-itemproperty C:\Windows

描述
-----------
這個命令會取得 C:\Windows 目錄的相關資訊。

範例 2

C:\PS>get-itemproperty C:\Test\Weather.xls | format-list

描述
-----------
這個命令會取得 C:\Test\Weather.xls 檔案的屬性。結果會傳入 Format-List Cmdlet 以清單形式顯示輸出。

範例 3

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

描述
-----------
這個命令會顯示 CurrentVersion 登錄子機碼所包含之每個登錄項目的值名稱和資料。請注意，此命令必須有對應至此登錄之 HKEY_LOCAL_MACHINE Hive 的 Windows PowerShell 磁碟機 (名稱為 HKLM:)。在 Windows PowerShell 中，預設會提供具有該名稱和對應關係的磁碟機。或者，可使用下面以提供者名稱開頭並加上兩個冒號的替代路徑，指定這個登錄子機碼的路徑：
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion。

範例 4

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion `
-name "ProgramFilesDir"

描述
-----------
這個命令會取得 CurrentVersion 登錄子機碼中 ProgramFilesDir 登錄項目的值名稱和資料。這個命令使用 Path 參數指定子機碼，並且使用 Name 參數指定項目的值名稱。

範例 5

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad
                          364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

描述
-----------
這個命令會取得 PowerShellEngine 登錄子機碼中所有登錄項目的值名稱和資料。下列範例的輸出會顯示結果。

範例 6

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

Path                                                        ExecutionPolicy
----                                                        ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe   RemoteSigned


C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | format-list -property *

PSPath          : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
                  soft.PowerShell
PSParentPath    : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName     : Microsoft.PowerShell
PSDrive         : HKLM
PSProvider      : Microsoft.PowerShell.Core\Registry
Path            : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned

描述
-----------
這個範例示範如何將 Get-ItemProperty 命令的輸出以清單格式呈現，讓您輕鬆查看登錄值與資料及解譯結果。

第一個命令使用 Get-ItemProperty Cmdlet 取得 Microsoft.PowerShell 子機碼中的登錄項目。這個子機碼儲存了 Windows PowerShell 預設殼層的選項。下列範例的輸出會顯示結果。

輸出顯示兩種登錄項目：Path 與 ExecutionPolicy。登錄機碼包含的項目不到五個，所以預設為以表格顯示，但是，在清單中檢視通常會更容易。

第二個命令使用相同的 Get-ItemProperty 命令。不過，這一次，該命令會使用管線運算子 (|)，將命令的結果傳送給 Format-List Cmdlet。Format-List 命令使用 Property 參數並配合 * (所有) 值，以清單顯示物件的所有屬性。下列範例的輸出會顯示結果。

產生的顯示會列出 Path and ExecutionPolicy 登錄項目以及幾個不太相似的登錄機碼物件的屬性。其他首碼為 "PS" 的屬性是 Windows PowerShell 自訂物件的屬性，例如表示登錄機碼的物件。

請參閱



目錄