Get-ChildItem

Get-ChildItem
    [[-Path] <string[]>]
    [[-Filter] <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint>]
    [-Force]
    [-Name]
    [<CommonParameters>]

Get-ChildItem
    [[-Filter] <string>]
    -LiteralPath <string[]>
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-Depth <uint>]
    [-Force]
    [-Name]
    [<CommonParameters>]

Cmdleten Get-ChildItem hämtar objekten på en eller flera angivna platser. Om objektet är en container hämtar det objekten i containern, så kallade underliggande objekt. Du kan använda parametern Recurse för att få åtkomst till objekt i alla underordnade containrar och använda parametern Depth för att begränsa antalet nivåer som ska genomsökas.

Get-ChildItem visar inte tomma kataloger. När ett Get-ChildItem-kommando innehåller parametrarna Depth eller Recurse inkluderas inte tomma kataloger i utdata.

Cmdleten Get-ChildItem är utformad för att fungera med objekt som exponeras av alla leverantörer. Objekt kan till exempel vara en filsystemfil eller katalog, registreringsdatafil eller ett certifikatarkiv. Använd kommandot Get-PSProvider om du vill visa en lista över de leverantörer som är tillgängliga i sessionen. Vissa parametrar är endast tillgängliga för en specifik provider. Mer information finns i om_Leverantörer.

Det här exemplet hämtar underordnade objekt från en filsystemkatalog. Filnamnen och underkatalognamnen visas. För tomma platser returnerar kommandot inga utdata och återgår till PowerShell-prompten.

Cmdleten Get-ChildItem använder parametern Path för att ange katalogen C:\Test. Get-ChildItem visar filerna och katalogerna i PowerShell-konsolen.

Get-ChildItem -Path C:\Test

   Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     08:29                Logs
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a----         2/1/2019     08:43            183 CreateTestFile.ps1
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Som standard visar Get-ChildItem läget (Attribut), LastWriteTime, filstorlek (Längd) och Namn för objektet. Bokstäverna i egenskapen Mode kan tolkas på följande sätt:

• l (länk)
• d (katalog)
• a (arkiv)
• r (skrivskyddad)
• h (dold)
• s (system)

Mer information om lägesflaggor finns i about_FileSystem_Provider.

I det här exemplet visas endast namnen på objekt i en katalog.

Cmdleten Get-ChildItem använder parametern Path för att ange katalogen C:\Test. Parametern Name returnerar endast fil- eller katalognamnen från den angivna sökvägen. De namn som returneras är relativa till värdet för parametern Path.

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

Det här exemplet visar .txt filer som finns i den aktuella katalogen och dess underkataloger.

Get-ChildItem -Path .\*.txt -Recurse -Force

    Directory: C:\Test\Logs\Adirectory

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile4.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile4.txt

    Directory: C:\Test\Logs\Backup

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 ATextFile.txt
-a----        2/12/2019     15:50             20 LogFile3.txt

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Cmdleten Get-ChildItem använder parametern Path för att ange C:\Test\*.txt. Path använder jokertecknet asterisk (*) för att ange alla filer med filnamnstillägget .txt. Parametern Recurse söker i katalogen Path och dess underkataloger, som visas under rubriken Directory:. Parametern Force visar dolda filer, till exempel hiddenfile.txt som har läget h.

I det här exemplet använder Get-ChildItem parametern Include för att hitta specifika objekt från katalogen som anges av parametern Path.

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt

Get-ChildItem -Path C:\Test\* -Include *.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Cmdleten Get-ChildItem använder parametern Path för att ange katalogen C:\Test. Parametern Path innehåller ett avslutande asterisk (*) jokertecken för att ange katalogens innehåll. Parametern Include använder ett asterisk (*) jokertecken för att ange alla filer med filnamnstillägget .txt.

När parametern Include används behöver parametern Path ett avslutande asterisk (*) jokertecken för att ange katalogens innehåll. Till exempel -Path C:\Test\*.

• Om parametern Recurse läggs till i kommandot är den avslutande asterisken (*) i parametern Path valfri. Parametern Recurse hämtar objekt från katalogen Path och dess underkataloger. Till exempel: -Path C:\Test\ -Recurse -Include *.txt
• Om en avslutande asterisk (*) inte ingår i parametern Path returnerar kommandot inga utdata och återgår till PowerShell-prompten. Till exempel -Path C:\Test\.

Exemplets utdata visar innehållet i katalogen C:\Test\Logs. Utdata är en referens för de andra kommandon som använder parametrarna Exclude och Recurse.

Get-ChildItem -Path C:\Test\Logs

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Cmdleten Get-ChildItem använder parametern Path för att ange katalogen C:\Test\Logs. Parametern Exclude använder jokertecknet asterisk (*) för att ange filer eller kataloger som börjar med A eller a undantas från utdata.

När parametern Exclude används är en avslutande asterisk (*) i parametern Path valfri. Till exempel -Path C:\Test\Logs eller -Path C:\Test\Logs\*.

• Om en avslutande asterisk (*) inte ingår i parametern Path visas innehållet i parametern Path. Undantagen är filnamn eller underkatalognamn som matchar värdet för parametern Exclude.
• Om en avslutande asterisk (*) ingår i parametern Path visas kommandot i Path parameterns underkataloger. Undantagen är filnamn eller underkatalognamn som matchar värdet för parametern Exclude.
• Om parametern Recurse läggs till i kommandot är rekursionsutdata samma oavsett om parametern Path innehåller en avslutande asterisk (*).

Det här exemplet hämtar alla registernycklar från HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem använder parametern Path för att ange registernyckeln HKLM:\HARDWARE. Bikupans sökväg och översta nivån av registernycklarna visas i PowerShell-konsolen.

Mer information finns i about_Registry_Provider.

Get-ChildItem -Path HKLM:\HARDWARE

    Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name             Property
----             --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI

Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*

   Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name                           Property
----                           --------
ACPI
RESOURCEMAP

Det första kommandot visar innehållet i HKLM:\HARDWARE-registernyckeln. Parametern Exclude anger att Get-ChildItem inte ska returnera några undernycklar som börjar med D*. För närvarande fungerar parametern Exclude endast på undernycklar, inte objektegenskaper.

Det här exemplet hämtar varje certifikat på PowerShell Cert:-enheten som har kodsigneringsbehörighet.

Cmdleten Get-ChildItem använder parametern Path för att ange certifikatleverantören med enheten Cert:. Parametern Recurse söker i katalogen som anges av Path och dess underkataloger. Parametern CodeSigningCert hämtar endast certifikat som har kodsigneringsbehörighet.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

För mer information om certifikatutgivaren och Cert:-enheten, se about_Certificate_Provider.

I det här exemplet visas objekten i en katalog och dess underkataloger. Parametern Depth avgör antalet underkatalognivåer som ska inkluderas i rekursionen. Tomma kataloger undantas från utdata.

Get-ChildItem -Path C:\Parent -Depth 2

    Directory: C:\Parent

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level1
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level2
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1\SubDir_Level2

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:22                SubDir_Level3
-a----        2/13/2019     08:55             26 file.txt

Cmdleten Get-ChildItem använder parametern Path för att ange C:\Parent. Parametern Depth anger två rekursionsnivåer. Get-ChildItem visar innehållet i katalogen som anges av parametern Path och de två nivåerna av underkataloger.

I PowerShell 6.2 lades en alternativ vy till för att hämta hård länkinformation.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

I PowerShell 7.1 på Unix-system tillhandahåller Get-ChildItem Unix-liknande utdata:

PS> Get-ChildItem /etc/r*

    Directory: /etc

UnixMode   User Group    LastWriteTime Size Name
--------   ---- -----    ------------- ---- ----
drwxr-xr-x root wheel  9/30/2019 19:19  128 racoon
-rw-r--r-- root wheel  9/26/2019 18:20 1560 rc.common
-rw-r--r-- root wheel  7/31/2017 17:30 1560 rc.common~previous
-rw-r--r-- root wheel  9/27/2019 20:34 5264 rc.netboot
lrwxr-xr-x root wheel  11/8/2019 15:35   22 resolv.conf -> /private/var/run/resolv.conf
-rw-r--r-- root wheel 10/23/2019 17:41    0 rmtab
-rw-r--r-- root wheel 10/23/2019 17:41 1735 rpc
-rw-r--r-- root wheel  7/25/2017 18:37 1735 rpc~previous
-rw-r--r-- root wheel 10/23/2019 18:42  891 rtadvd.conf
-rw-r--r-- root wheel  8/24/2017 21:54  891 rtadvd.conf~previous

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

Kommandot dir i Windows-kommandogränssnittet visar målplatsen för en kopplingspunkt för filsystemet. I PowerShell är den här informationen tillgänglig från egenskapen LinkTarget för filsystemobjektet som returneras av Get-ChildItem och visas i standardutdata.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $Env:TEMP
PS D:\> Get-ChildItem | Select-Object Name, LinkTarget

Name     LinkTarget
----     ----------
tmp      C:\Users\user1\AppData\Local\Temp

PS D:\> Get-ChildItem

    Directory: D:\

Mode          LastWriteTime    Length Name
----          -------------    ------ ----
l----   12/16/2021  9:29 AM           tmp -> C:\Users\user1\AppData\Local\Temp

Det här exemplet försöker hämta målinformationen för en AppX-referenspunkt. Microsoft Store-program skapar AppX-referenspunkter i användarens AppData-katalog.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

För närvarande tillhandahåller Inte Windows något sätt att hämta målinformationen för en AppX-referenspunkt. Egenskaperna LinkTarget och LinkType för filsystemobjektet är tomma.

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.

Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.

Cmdleten skriver ut den här typen vid åtkomst till Alias:-enheten.

Vid åtkomst av Cert:-enheten matar cmdleten ut dessa typer.

Cmdleten skriver ut den här typen vid åtkomst till Env:-enheten.

Cmdleten matar ut dessa typer vid åtkomst till FileSystem-enheterna.

Cmdleten skriver ut dessa typer vid åtkomst till Function:-enheterna.

Cmdlet-kommandot matar ut den här typen vid åtkomst till registrydrivarna.

Cmdleten matar ut den här typen vid åtkomst till Variable: enheter.

Cmdleten skriver ut dessa typer vid åtkomst till WSMan:-enheterna.

När du använder parametern Name returnerar den här cmdleten objektnamnen som strängar.

PowerShell innehåller följande alias för Get-ChildItem:

• Alla plattformar:
  • dir, gci
• Windows:
  • ls

Rekursionsbeteende med parametern Path:

När du använder Get-ChildItem -Recurse med parametern Path söker cmdleten efter den sista sökvägskomponenten oavsett om det är ett jokerteckenmönster eller ett literalt namn.

• Om den sista sökvägskomponenten matchar en befintlig omedelbar underkatalog i målkatalogen utför cmdleten rekursiv uppräkning i den matchande katalogen.
• Om den sista sökvägskomponenten inte matchar en befintlig omedelbar underkatalog för målkatalogen söker cmdleten rekursivt i målkatalogens hierarki efter objekt som matchar den sista sökvägskomponenten

När du använder Get-ChildItem -Recurse med parametrarna Path och Name ändras beteendet. Kommandot söker efter den sista sökvägskomponenten bland de omedelbara underordnade objekten i målkatalogen.

• Om det finns en matchning mellan de omedelbara underordnade objekten utför cmdleten rekursiv uppräkning på matchande objekt. Jokerteckenmatchning sker bara en gång, på den översta nivån i målkatalogen. Resultaten bearbetas som om de hade skickats individuellt till parametern LiteralPath.
• Om den sista sökvägskomponenten inte matchar några objekt på den översta nivån uppstår ett fel.

Du bör undvika att använda parametern Path med parametern Recurse. För bästa resultat:

• Använd LiteralPath för att ange målkatalogen för att undvika att utlösa en rekursiv sökning efter den sista sökvägskomponenten.
• Använd Filter eller Inkludera parametrar för att ange jokertecken eller literalmönster som ska sökas efter på alla nivåer i målkatalogens hierarki.