Udostępnij za pośrednictwem

Get-Item

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

Pobiera element w określonej lokalizacji.

Składnia

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

Opis

Polecenie cmdlet Get-Item pobiera element w określonej lokalizacji. Nie pobiera zawartości elementu w lokalizacji, chyba że używasz symbolu wieloznakowego ('*'), aby zażądać całej zawartości elementu.

To polecenie cmdlet jest używane przez dostawców programu PowerShell do nawigowania po różnych typach magazynów danych.

Przykłady

Przykład 1. Pobieranie bieżącego katalogu

To polecenie pobiera bieżący katalog. Kropka ('.') reprezentuje element w bieżącej lokalizacji (a nie jego zawartość).

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Przykład 2. Pobieranie wszystkich elementów w bieżącym katalogu

To polecenie pobiera wszystkie elementy w bieżącym katalogu. Symbol wieloznaczny ('*') reprezentuje całą zawartość bieżącego elementu.

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

Przykład 3. Pobieranie bieżącego katalogu dysku

To polecenie pobiera bieżący katalog dysku C: . Pobrany obiekt reprezentuje tylko katalog, a nie jego zawartość.

Get-Item C:\

Przykład 4. Pobieranie elementów na określonym dysku

To polecenie pobiera elementy na dysku C:. Symbol wieloznaczny ('*') reprezentuje wszystkie elementy w kontenerze, a nie tylko kontener.

W programie PowerShell użyj pojedynczej gwiazdki (''), aby uzyskać zawartość, zamiast tradycyjnej ".". Format jest interpretowany dosłownie, więc ".*" nie pobiera katalogów ani nazw plików bez kropki.

Get-Item C:\*

Przykład 5. Pobieranie właściwości w określonym katalogu

To polecenie pobiera właściwość LastAccessTime katalogu "C:\Windows". LastAccessTime jest tylko jedną właściwością katalogów systemu plików. Aby wyświetlić wszystkie właściwości katalogu, wpisz (Get-Item \<directory-name\>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

Przykład 6. Wyświetlanie zawartości klucza rejestru

To polecenie pokazuje zawartość klucza rejestru Microsoft.PowerShell. Możesz użyć tego polecenia cmdlet z dostawcą rejestru programu PowerShell, aby uzyskać klucze rejestru i podklucze, ale musisz użyć polecenia cmdlet Get-ItemProperty, aby uzyskać wartości rejestru i dane.

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Przykład 7. Pobieranie elementów w katalogu z wykluczeniem

To polecenie pobiera elementy w katalogu systemu Windows z nazwami, które zawierają kropkę ('.'), ale nie zaczynają się od "w*". To polecenie działa tylko wtedy, gdy ścieżka zawiera symbol wieloznaczny ('*'), aby określić zawartość elementu.

Get-Item c:\Windows\*.* -Exclude "w*"

Parametry

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to bieżący użytkownik.

Wpisz nazwę użytkownika, taką jak "User01" lub "Domain01\User01", lub wprowadź obiekt PSCredential, taki jak jeden wygenerowany przez polecenie cmdlet Get-Credential. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o podanie hasła.

Ostrzeżenie

Ten parametr nie jest obsługiwany przez żadnych dostawców zainstalowanych w programie Windows PowerShell.

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 w formacie lub języku dostawcy. Wartość tego parametru kwalifikuje parametr Path.

Składnia filtru, w tym użycie symboli wieloznacznych, zależy od dostawcy. 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

-Force

Wskazuje, że to polecenie cmdlet pobiera elementy, do których nie można uzyskać dostępu, na przykład ukryte elementy. Implementacja różni się od dostawcy do dostawcy. Aby uzyskać więcej informacji, zobacz about_Providers. Nawet przy użyciu parametru Force polecenie cmdlet nie może zastąpić ograniczeń zabezpieczeń.

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

-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 elementu. W przeciwieństwie do parametru Path 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.

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

-Path

Określa ścieżkę do elementu. To polecenie cmdlet pobiera element w określonej lokalizacji. Dozwolone są symbole wieloznaczne. Ten parametr jest wymagany, ale nazwa parametru ("Ścieżka") jest opcjonalna.

Użyj kropki ('.'), aby określić bieżącą lokalizację. Użyj symbolu wieloznakowego ('*'), aby określić wszystkie elementy w bieżącej lokalizacji.

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

-Stream

Pobiera określony alternatywny strumień plików NTFS z pliku. Wprowadź nazwę strumienia. Obsługiwane są symbole wieloznaczne. Aby pobrać wszystkie strumienie, użyj gwiazdki (*). Ten parametr jest nieprawidłowy w folderach.

Stream to parametr dynamiczny, który dostawca systemu plików dodaje do polecenia cmdlet Get-Item. Ten parametr działa tylko na dyskach systemu plików.

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

-UseTransaction

Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę do tego polecenia cmdlet.

Dane wyjściowe

Object

To polecenie cmdlet zwraca obiekty, które otrzymuje. Typ jest określany przez typ obiektów w ścieżce.

Uwagi

To polecenie cmdlet nie ma parametru Recurse, ponieważ pobiera tylko element, a nie jego zawartość. Aby uzyskać zawartość elementu rekursywnie, użyj Get-ChildItem.

Aby przejść przez rejestr, użyj tego polecenia cmdlet, aby uzyskać klucze rejestru i Get-ItemProperty, aby uzyskać wartości rejestru i dane. Wartości rejestru są uważane za właściwości klucza rejestru.

To polecenie cmdlet 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.