Udostępnij za pośrednictwem

Get-ItemProperty

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Pobiera właściwości określonego elementu.

Składnia

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-ItemProperty pobiera właściwości określonych elementów. Możesz na przykład użyć tego polecenia cmdlet, aby uzyskać wartość właściwości LastAccessTime obiektu pliku. Możesz również użyć tego polecenia cmdlet, aby wyświetlić wpisy rejestru i ich wartości.

Przykłady

Przykład 1. Uzyskiwanie informacji o określonym katalogu

To polecenie pobiera informacje o katalogu C:\Windows.

Get-ItemProperty C:\Windows

Przykład 2. Pobieranie właściwości określonego pliku

To polecenie pobiera właściwości pliku C:\Test\Weather.xls. Wynik jest przesyłany potokiem do polecenia cmdlet Format-List w celu wyświetlenia danych wyjściowych jako listy.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Przykład 3. Pobieranie nazwy wartości i danych wpisu rejestru w podkluczu rejestru

To polecenie pobiera nazwę wartości i dane wpisu rejestru ProgramFilesDir w podkluczu rejestru CurrentVersion. Ścieżka określa podklucz, a parametr Nazwa określa nazwę wartości wpisu.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Nuta

To polecenie wymaga dysku programu PowerShell o nazwie HKLM: mapowanego na gałąź rejestru HKEY_LOCAL_MACHINE.

Dysk o tej nazwie i mapowaniu jest domyślnie dostępny w programie PowerShell. Alternatywnie ścieżkę do tego podklucza rejestru można określić przy użyciu następującej alternatywnej ścieżki, która zaczyna się od nazwy dostawcy, po której następują dwa dwukropki:

Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

Przykład 4. Pobieranie nazw wartości i danych wpisów rejestru w kluczu rejestru

To polecenie pobiera nazwy wartości i dane wpisów rejestru w kluczu rejestru PowerShellEngine. Wyniki są wyświetlane w poniższych przykładowych danych wyjściowych.

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=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

Parametry

-Credential

Nuta

Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie PowerShell. Aby personifikować innego użytkownika lub podnieść poziom poświadczeń podczas uruchamiania tego polecenia cmdlet, użyj Invoke-Command.

Typ:PSCredential
Position:Named
Domyślna wartość:Current user
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Exclude

Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet wyklucza w operacji. Wartość tego parametru kwalifikuje parametr Path. Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są symbole wieloznaczne. Parametr Exclude jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Filter

Określa filtr, aby zakwalifikować parametr ścieżki . Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell obsługującym korzystanie z filtrów. Składnię języka filtru systemu plików można znaleźć w about_Wildcards. Filtry są wydajniejsze niż inne parametry, ponieważ dostawca stosuje je, gdy polecenie cmdlet pobiera obiekty zamiast filtrować obiekty po ich pobraniu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Include

Określa jako tablicę ciągów element lub elementy, które to polecenie cmdlet zawiera w operacji. Wartość tego parametru kwalifikuje parametr Path. Wprowadź element ścieżki lub wzorzec, taki jak *.txt. Dozwolone są symbole wieloznaczne. Parametr Include jest skuteczny tylko wtedy, gdy polecenie zawiera zawartość elementu, na przykład C:\Windows\*, gdzie symbol wieloznaczny określa zawartość katalogu C:\Windows.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-LiteralPath

Określa ścieżkę do co najmniej jednej lokalizacji. Wartość LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę właściwości lub właściwości do pobrania. Dozwolone są symbole wieloznaczne.

Typ:String[]
Aliasy:PSProperty
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Path

Określa ścieżkę do elementu lub elementów. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę do Get-ItemProperty.

Dane wyjściowe

System.Boolean, System.String, System.DateTime

Get-ItemProperty zwraca obiekt dla każdej właściwości elementu, którą otrzymuje. Typ obiektu zależy od pobranego obiektu. Na przykład na dysku systemu plików może zwrócić plik lub folder.

Uwagi

Polecenie cmdlet Get-ItemProperty jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.