Get-Item

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>]
   [-Stream <string[]>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-Stream <string[]>]
   [<CommonParameters>]

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-Item
   [-Path] <string[]>
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [<CommonParameters>]

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

Opis

Polecenie Get-Item cmdlet 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 przechodzenia przez różne typy magazynów danych. Niektóre parametry są dostępne tylko dla określonego dostawcy. Aby uzyskać więcej informacji, zobacz about_Providers.

Przykłady

Przykład 1. Pobieranie bieżącego katalogu

W tym przykładzie jest pobierany 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

Ten przykład 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

Ten przykład pobiera bieżący katalog C: dysku. Pobrany obiekt reprezentuje tylko katalog, a nie jego zawartość.

Get-Item C:

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

Ten przykład pobiera elementy na C: dysku. Symbol wieloznaczny (*) reprezentuje wszystkie elementy w kontenerze, a nie tylko kontener.

Get-Item C:\*

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

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

W tym przykładzie jest pobierana właściwość C:\WindowsLastAccessTime katalogu. LastAccessTime to tylko jedna właściwość 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

W tym przykładzie przedstawiono zawartość klucza rejestru Microsoft.PowerShell . To polecenie cmdlet można użyć z dostawcą rejestru programu PowerShell, aby uzyskać klucze rejestru i podklucze, ale musisz użyć Get-ItemProperty polecenia cmdlet , 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

Ten przykład pobiera elementy w katalogu systemu Windows z nazwami zawierającymi kropkę (.), ale nie zaczynają się od w*. Ten przykład działa tylko wtedy, gdy ścieżka zawiera symbol wieloznaczny (*), aby określić zawartość elementu.

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

Przykład 8. Uzyskiwanie informacji o twardym łączem

W programie PowerShell 6.2 dodano widok alternatywny, aby uzyskać informacje o twardych linkach. Aby uzyskać informacje o twardym łączem, należy przekazać dane wyjściowe do Format-Table -View childrenWithHardlink

Get-Item C:\Windows\System32\ntoskrnl.exe | Format-Table -view childrenWithHardLink

Directory: C:\Windows\System32

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---           5/12/2021  7:40 AM       10848576 ntoskrnl.exe

Właściwość Mode identyfikuje hardlink przez element l w la---

Przykład 9. Dane wyjściowe dla systemów operacyjnych innych niż Windows

W programie PowerShell 7.1 w systemach Get-Item Unix polecenie cmdlet zapewnia dane wyjściowe podobne do systemu Unix:

PS> Get-Item /Users

Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

Nowe właściwości, które są teraz częścią danych wyjściowych, to:

• UnixMode to uprawnienia do plików reprezentowane w systemie Unix
• Użytkownik jest właścicielem pliku
• Grupa jest właścicielem grupy
• Rozmiar to rozmiar pliku lub katalogu reprezentowanego w systemie Unix

Uwaga

Ta funkcja została przeniesiona z eksperymentalnego do głównego nurtu w programie PowerShell 7.1.

Parametry

-CodeSigningCert

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Aby uzyskać certyfikaty, które mają Code Signing wartość właściwości EnhancedKeyUsageList , użyj parametru CodeSigningCert .

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Uwaga

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 polecenia Invoke-Command.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DnsName

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Określa nazwę domeny lub wzorzec nazwy, który ma być zgodny z właściwością DNSNameList certyfikatów pobierane przez polecenie cmdlet. Wartość tego parametru może być lub UnicodeASCII. Wartości punycode są konwertowane na Unicode. Symbole wieloznaczne (*) są dozwolone.

Ten parametr został przywrócony w programie PowerShell 7.1

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	DnsNameRepresentation
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-DocumentEncryptionCert

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Aby uzyskać certyfikaty, które mają Document Encryption wartość właściwości EnhancedKeyUsageList , użyj parametru DocumentEncryptionCert .

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Eku

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Określa tekst lub wzorzec tekstu zgodny z właściwością EnhancedKeyUsageList certyfikatów pobierane przez polecenie cmdlet. Symbole wieloznaczne (*) są dozwolone. Właściwość EnhancedKeyUsageList zawiera przyjazną nazwę i pola OID EKU.

Ten parametr został przywrócony w programie PowerShell 7.1

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-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ść C:\Windows katalogu.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-ExpiringInDays

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Określa, że polecenie cmdlet powinno zwracać tylko certyfikaty wygasające lub przed określoną liczbą dni. Wartość zero (0) pobiera certyfikaty, które wygasły.

Ten parametr został przywrócony w programie PowerShell 7.1

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Określa filtr w celu zakwalifikowania parametru Ścieżka . Dostawca systemu plików jest jedynym zainstalowanym dostawcą programu PowerShell, który obsługuje filtry. Filtry są bardziej wydajne niż inne parametry. Dostawca stosuje filtr, gdy polecenie cmdlet pobiera obiekty zamiast filtrować obiekty programu PowerShell po ich pobraniu. Ciąg filtru jest przekazywany do interfejsu API platformy .NET w celu wyliczenia plików. Interfejs API obsługuje * tylko symbole wieloznaczne i ? .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ń.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ść C:\Windows katalogu.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-LiteralPath

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

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 ścieżka nazwy parametru jest opcjonalna.

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-SSLServerAuthentication

Jest to parametr dynamiczny udostępniany przez dostawcę certyfikatów . Ten parametr i dostawca certyfikatów są dostępne tylko w systemie Windows.

Aby uzyskać certyfikaty, które mają Server Authentication wartość właściwości EnhancedKeyUsageList , użyj parametru SSLServerAuthentication .

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Stream

Jest to parametr dynamiczny udostępniany przez dostawcę systemu plików . Ten parametr jest dostępny tylko w systemie Windows.

Pobiera określony alternatywny strumień danych z pliku. Wprowadź nazwę strumienia. Obsługiwane są symbole wieloznaczne. Aby pobrać wszystkie strumienie, użyj gwiazdki (*). Ten parametr jest prawidłowy w katalogach, ale należy pamiętać, że katalogi nie mają domyślnie strumieni danych.

Ten parametr został wprowadzony w programie PowerShell 3.0. Od programu PowerShell 7.2 Get-Item można pobierać alternatywne strumienie danych z katalogów, a także plików.

Aby uzyskać więcej informacji, zobacz about_FileSystem_Provider.

Type:	String[]
Position:	Named
Default value:	No alternate file streams
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

Dane wejściowe

String

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

Dane wyjściowe

AliasInfo

Polecenie cmdlet generuje ten typ podczas uzyskiwania Alias: dostępu do dysku.

X509StoreLocation

X509Store

X509Certificate2

Polecenie cmdlet generuje te typy podczas uzyskiwania Cert: dostępu do dysku.

DictionaryEntry

Polecenie cmdlet generuje ten typ podczas uzyskiwania Env: dostępu do dysku.

DirectoryInfo

FileInfo

Polecenie cmdlet generuje te typy podczas uzyskiwania dostępu do dysków systemu plików.

FunctionInfo

FilterInfo

Polecenie cmdlet generuje te typy podczas uzyskiwania Function: dostępu do dysków.

RegistryKey

Polecenie cmdlet generuje ten typ podczas uzyskiwania dostępu do dysków rejestru.

PSVariable

Polecenie cmdlet generuje ten typ podczas uzyskiwania Variable: dostępu do dysków.

WSManConfigContainerElement

WSManConfigLeafElement

Polecenie cmdlet generuje te typy podczas uzyskiwania WSMan: dostępu do dysków.

Uwagi

Program PowerShell zawiera następujące aliasy dla Get-Itemprogramu :

• Wszystkie platformy:
  • gi

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

Aby przejść przez rejestr, użyj tego polecenia cmdlet, aby uzyskać klucze rejestru i Get-ItemProperty 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.

Linki powiązane

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider
• about_Providers