Get-Item
Hämtar objektet på den angivna platsen.
Syntax
Path (Standard)
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
Description
Cmdleten Get-Item hämtar objektet på den angivna platsen. Det hämtar inte innehållet i objektet på platsen om du inte använder ett jokertecken (*) för att begära allt innehåll i objektet.
Den här cmdleten används av PowerShell-leverantörer för att navigera genom olika typer av datalager.
Exempel
Exempel 1: Hämta den aktuella katalogen
Det här exemplet hämtar den aktuella katalogen. Punkten ('.') representerar objektet på den aktuella platsen (inte dess innehåll).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Exempel 2: Hämta alla objekt i den aktuella katalogen
Det här exemplet hämtar alla objekt i den aktuella katalogen. Jokertecknet (*) representerar allt innehåll i det aktuella objektet.
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
Exempel 3: Hämta den aktuella katalogen för en enhet
Det här exemplet hämtar den aktuella katalogen för enhet C:. Objektet som hämtas representerar bara katalogen, inte dess innehåll.
Get-Item C:
Exempel 4: Hämta objekt på den angivna enheten
Det här exemplet hämtar objekten i C:-enheten. Jokertecknet (*) representerar alla objekt i containern, inte bara containern.
Get-Item C:\*
I PowerShell använder du en enda asterisk (*) för att hämta innehåll i stället för den traditionella *.*. Formatet tolkas bokstavligen, så *.* skulle inte hämta kataloger eller filnamn utan en punkt.
Exempel 5: Hämta en egenskap i den angivna katalogen
Det här exemplet hämtar egenskapen LastAccessTime för katalogen C:\Windows.
LastAccessTime är bara en egenskap för filsystemkataloger. Om du vill se alla egenskaper för en katalog skriver du (Get-Item <directory-name>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
Exempel 6: Visa innehållet i en registernyckel
Det här exemplet visar innehållet i Microsoft.PowerShell registernyckel. Du kan använda den här cmdleten med PowerShell-registerprovidern för att hämta registernycklar och undernycklar, men du måste använda cmdleten Get-ItemProperty för att hämta registervärden och data.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
Exempel 7: Hämta objekt i en katalog som har ett undantag
Det här exemplet hämtar objekt i Windows-katalogen med namn som innehåller en punkt (.), men som inte börjar med w*. Det här exemplet fungerar bara när sökvägen innehåller ett jokertecken (*) för att ange innehållet i objektet.
Get-Item C:\Windows\*.* -Exclude "w*"
Exempel 8: Hämta hårdlänksinformation
I PowerShell 6.2 lades en alternativ vy till för att hämta hårdlänksinformation. Skicka utdata till Format-Table -View childrenWithHardlink för att hämta hårdlänksinformationen
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
Egenskapen Mode identifierar hårdlänken genom l i la---
Exempel 9: Utdata för operativsystem som inte kommer från Windows
I PowerShell 7.1 på Unix-system ger cmdleten Get-Item Unix-liknande utdata:
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 Users
De nya egenskaperna som nu är en del av utdata är:
- UnixMode är filbehörigheterna som representeras i ett Unix-system
- Användarens är filägaren
- Group är gruppägaren
- Storlek är storleken på filen eller katalogen som representeras i ett Unix-system
Anmärkning
Den här funktionen har flyttats från experimentell till mainstream i PowerShell 7.1.
Parametrar
-Credential
Anmärkning
Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | Current user |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Exclude
Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten exkluderar i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts. Parametern Exclude gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Filter
Anger ett filter för att kvalificera parametern Path.
FileSystem-providern är den enda installerade PowerShell-providern som stöder filter. Filter är effektivare än andra parametrar. Providern tillämpar filter när cmdleten hämtar objekten i stället för att PowerShell filtrerar objekten när de har hämtats. Filtersträngen skickas till .NET API för att räkna upp filer. API:et stöder endast * och ? jokertecken.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Anger att den här cmdleten hämtar objekt som annars inte kan nås, till exempel dolda objekt. Implementeringen varierar från leverantör till leverantör. Mer information finns i om_Leverantörer. Även om du använder parametern Force kan cmdleten inte åsidosätta säkerhetsbegränsningar.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Include
Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts. Parametern Include gäller endast när kommandot innehåller innehållet i ett objekt, till exempel C:\Windows\*, där jokertecknet anger innehållet i katalogen C:\Windows.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-LiteralPath
Anger en sökväg till en eller flera platser. Värdet för LiteralPath- används exakt som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.
Mer information finns i about_Quoting_Rules.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | PSPath, SP |
Parameteruppsättningar
LiteralPath
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Path
Anger sökvägen till ett objekt. Den här cmdleten hämtar objektet på den angivna platsen. Jokertecken tillåts. Den här parametern krävs, men parameternamnet Sökväg är valfritt.
Använd en punkt (.) för att ange den aktuella platsen. Använd jokertecknet (*) för att ange alla objekt på den aktuella platsen.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
Path
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Stream
Anmärkning
Den här parametern är endast tillgänglig i Windows.
Hämtar den angivna alternativa NTFS-filströmmen från filen. Ange namnet på streamen. Jokertecken stöds. Om du vill hämta alla strömmar använder du en asterisk (*). Den här parametern är inte giltig för mappar.
Stream är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Item.
Den här parametern fungerar bara på filsystemenheter.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | No alternate file streams |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
String
Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.
Utdata
Object
Den här cmdleten returnerar de objekt som den får. Typen bestäms av typen av objekt i sökvägen.
Kommentarer
Den här cmdleten har ingen Recurse parameter, eftersom den bara hämtar ett objekt, inte dess innehåll.
Om du vill hämta innehållet i ett objekt rekursivt använder du Get-ChildItem.
Om du vill navigera i registret använder du den här cmdleten för att hämta registernycklar och Get-ItemProperty för att hämta registervärden och data. Registervärdena anses vara egenskaper för registernyckeln.
Den här cmdleten är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PsProvider. Mer information finns i om_Leverantörer.