Get-ChildItem

Referens

Modul:: Microsoft.PowerShell.Management

Hämtar objekt och underordnade objekt på en eller flera angivna platser.

Syntax

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>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Description

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.

Platser exponeras för Get-ChildItem av PowerShell-leverantörer. En plats kan vara en filsystemkatalog, registerdatafil eller ett certifikatarkiv. Vissa parametrar är endast tillgängliga för en specifik provider. Mer information finns i about_Providers.

Exempel

Exempel 1: Hämta underordnade objekt från en filsystemkatalog

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.

Exempel 2: Hämta underordnade objektnamn i en katalog

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

Exempel 3: Hämta underordnade objekt i den aktuella katalogen och underkatalogerna

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.

Exempel 4: Hämta underordnade objekt med hjälp av parametern Inkludera

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\.

Exempel 5: Hämta underobjekt med parametern Exkludera

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 (*).

Exempel 6: Hämta registernycklarna från en registerstruktur

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.

Exempel 7: Hämta alla certifikat med kodsigneringsbehörighet

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.

Exempel 8: Hämta objekt med hjälp av parametern Djup

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.

Exempel 9: Hämta hårdlänksinformation

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

Exempel 10: Utdata för icke-Windows-operativsystem

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

Notera

Den här funktionen har flyttats från experimentell till mainstream i PowerShell 7.1.

Exempel 11: Hämta länkmålet för en knutpunkt

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

Exempel 12: Hämta länkmålet för en AppX-referenspunkt

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.

Parametrar

-Attributes

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Hämtar filer och mappar med de angivna attributen. Den här parametern stöder alla attribut och låter dig ange komplexa kombinationer av attribut.

Om du till exempel vill hämta icke-systemfiler (inte kataloger) som är krypterade eller komprimerade skriver du:

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Om du vill hitta filer och mappar med vanliga attribut använder du parametern Attribut. Eller parametrarna Directory, File, Hidden, ReadOnlyoch System.

Parametern Attributes stöder följande egenskaper:

Arkiv
komprimerad
Enhet
Katalog
Krypterad
dold
IntegrityStream
Normal
NoScrubData
NotContentIndexed
offline
Skrivskyddad
Reperstyngdpunkt
SparseFile
System
tillfällig

En beskrivning av dessa attribut finns i FileAttributes uppräkning.

Om du vill kombinera attribut använder du följande operatorer:

! (INTE)
+ (OCH)
, (OR)

Använd inte blanksteg mellan en operator och dess attribut. Blanksteg accepteras efter kommatecken.

Använd följande förkortningar för vanliga attribut:

D (katalog)
H (dold)
R (skrivskyddad)
S (system)

Typ:	FlagsExpression<T>[FileAttributes]
Godkända värden:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CodeSigningCert

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Om du vill hämta en lista över certifikat som har Code Signing i egenskapsvärdet EnhancedKeyUsageList använder du parametern CodeSigningCert.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Depth

Den här parametern lades till i PowerShell 5.0 och gör att du kan kontrollera rekursionsdjupet. Som standard visar Get-ChildItem innehållet i den överordnade katalogen. Parametern Depth bestämmer antalet underkatalognivåer som ingår i rekursionen och visar innehållet.

Till exempel innehåller -Depth 2Path-parameterns katalog, den första nivån av underkataloger och den andra nivån av underkataloger. Som standard inkluderas katalognamn och filnamn i utdata.

Notera

På en Windows-dator från PowerShell eller cmd.exekan du visa en grafisk vy över en katalogstruktur med kommandot tree.com.

Typ:	UInt32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Directory

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Om du vill hämta en lista över kataloger använder du parametern Directory eller parametern Attributes med egenskapen Directory. Du kan använda parametern Recurse med Directory.

Typ:	SwitchParameter
Alias:	ad
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DnsName

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Anger ett domännamns- eller namnmönster som ska matcha med egenskapen DNSNameList för certifikat som cmdleten hämtar. Värdet för den här parametern kan antingen vara Unicode eller ASCII. Punycode-värden konverteras till Unicode. Jokertecken (*) tillåts.

Den här parametern återinfördes i PowerShell 7.1

Typ:	DnsNameRepresentation
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-DocumentEncryptionCert

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Om du vill hämta en lista över certifikat som har Document Encryption i egenskapsvärdet EnhancedKeyUsageList använder du parametern DocumentEncryptionCert.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Eku

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Anger text eller ett textmönster som ska matcha med egenskapen EnhancedKeyUsageList för certifikat som cmdleten hämtar. Jokertecken (*) tillåts. Egenskapen EnhancedKeyUsageList innehåller det beskrivande namnet och EKU:s OID-fält.

Den här parametern återinfördes i PowerShell 7.1

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-Exclude

Anger en array med ett eller flera strängmönster som ska matchas när cmdleten hämtar barnobjekt. Matchande objekt undantas från utdata. Ange ett sökvägselement eller mönster, till exempel *.txt eller A*. Jokertecken accepteras.

En avslutande asterisk (*) i parametern Path är valfri. Till exempel -Path C:\Test\Logs eller -Path C:\Test\Logs\*. Om en avslutande asterisk (*) ingår, upprepas kommandot i Path parameterns underkataloger. Utan asterisken (*) visas innehållet i parametern Path. Mer information finns i exempel 5 och avsnittet Anteckningar.

Parametrarna Include och Exclude kan användas tillsammans. Undantagen tillämpas dock efter inkluderingarna, vilket kan påverka de slutliga utdata.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-ExpiringInDays

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Anger att cmdleten endast ska returnera certifikat som upphör att gälla under eller före det angivna antalet dagar. Värdet noll (0) hämtar certifikat som har upphört att gälla.

Den här parametern återinfördes i PowerShell 7.1

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-File

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Om du vill hämta en lista över filer använder du parametern File. Du kan använda parametern Recurse med File.

Typ:	SwitchParameter
Alias:	af
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	String
Position:	1
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-FollowSymlink

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Som standard visar cmdleten Get-ChildItem symboliska länkar till kataloger som hittades under rekursionen, men återkommer inte till dem. Använd parametern FollowSymlink för att söka i katalogerna som riktar sig mot dessa symboliska länkar. FollowSymlink är en dynamisk parameter och stöds endast i FileSystem-providern.

Den här parametern introducerades i PowerShell 6.0.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Force

Tillåter att cmdleten hämtar objekt som annars inte kan nås av användaren, till exempel dolda filer eller systemfiler. Parametern Force åsidosätter inte säkerhetsbegränsningar. Implementeringen varierar mellan olika leverantörer. Mer information finns i about_Providers.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Hidden

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Om du bara vill hämta dolda objekt använder du parametern Hidden eller parametern Attributes med egenskapen Hidden. Som standard visar Get-ChildItem inte dolda objekt. Använd parametern Force för att hämta dolda objekt.

Typ:	SwitchParameter
Alias:	ah, h
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Include

Anger en array med ett eller flera strängmönster som ska matchas när cmdleten hämtar barnobjekt. Alla matchande objekt ingår i utdata. 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.

Parametrarna Include och Exclude kan användas tillsammans. Undantagen tillämpas dock efter inkluderingarna, vilket kan påverka de slutliga utdata.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	True

-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 jokertecken. 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.

Typ:	String[]
Alias:	PSPath, LP
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Hämtar endast namnen på objekten på platsen. Utdata är ett strängobjekt som kan skickas ned i pipelinen till andra kommandon. De namn som returneras är relativa till värdet för parametern Path.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Path

Anger en sökväg till en eller flera platser. Jokertecken accepteras. Standardplatsen är den aktuella katalogen (.).

Typ:	String[]
Position:	0
Standardvärde:	Current directory
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	True

-ReadOnly

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Om du bara vill hämta skrivskyddade objekt använder du parametern ReadOnly eller egenskapen Attributes parametern ReadOnly.

Typ:	SwitchParameter
Alias:	ar
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Recurse

Hämtar objekten på de angivna platserna och i alla underordnade objekt på platserna.

Typ:	SwitchParameter
Alias:	s, r
Position:	Named
Standardvärde:	False
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SSLServerAuthentication

Notera

Den här parametern är endast tillgänglig i leverantören Certificate.

Om du vill hämta en lista över certifikat som har Server Authentication i egenskapsvärdet EnhancedKeyUsageList använder du parametern SSLServerAuthentication.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-System

Notera

Den här parametern är endast tillgänglig i FileSystem-providern.

Hämtar endast systemfiler och kataloger. Om du bara vill hämta systemfiler och mappar använder du antingen parametern System eller parametern Attributes, eller egenskapen System.

Typ:	SwitchParameter
Alias:	as
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

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

Utdata

AliasInfo

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

X509StoreLocation

X509Store

X509Certificate2

Cmdleten matar ut dessa typer vid åtkomst av enheten Cert:.

DictionaryEntry

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

DirectoryInfo

FileInfo

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

FunctionInfo

FilterInfo

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

RegistryKey

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

PSVariable

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

WSManConfigContainerElement

WSManConfigLeafElement

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

String

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

Kommentarer

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

Alla plattformar:
- dir, gci
Windows:
- ls

Get-ChildItem får inte dolda objekt som standard. Om du vill hämta dolda objekt använder du parametern Force.

Cmdleten Get-ChildItem ä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 about_Providers.

Dela via

Get-ChildItem

Syntax

Description

Exempel

Exempel 1: Hämta underordnade objekt från en filsystemkatalog

Exempel 2: Hämta underordnade objektnamn i en katalog

Exempel 3: Hämta underordnade objekt i den aktuella katalogen och underkatalogerna

Exempel 4: Hämta underordnade objekt med hjälp av parametern Inkludera

Exempel 5: Hämta underobjekt med parametern Exkludera

Exempel 6: Hämta registernycklarna från en registerstruktur

Exempel 7: Hämta alla certifikat med kodsigneringsbehörighet

Exempel 8: Hämta objekt med hjälp av parametern Djup

Exempel 9: Hämta hårdlänksinformation

Exempel 10: Utdata för icke-Windows-operativsystem

Exempel 11: Hämta länkmålet för en knutpunkt

Exempel 12: Hämta länkmålet för en AppX-referenspunkt

Parametrar

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

Indata

Utdata

Kommentarer

Relaterade länkar

Ytterligare resurser