Get-ChildItem
Hämtar objekten 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ämtas objekten i containern, så kallade underordnade objekt. Du kan använda parametern Recurse för att hämta objekt i alla underordnade containrar och använda parametern Djup för att begränsa antalet nivåer som ska upprepas.
Get-ChildItem
visar inte tomma kataloger. När ett Get-ChildItem
kommando innehåller parametrarna Depth (Djup ) eller Recurse (Recurse ) ingår inte tomma kataloger i utdata.
Platser exponeras för Get-ChildItem
av PowerShell-leverantörer. En plats kan vara en filsystemkatalog, registreringsdatafil 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 Get-ChildItem
visas läget (attribut), LastWriteTime, filstorleken (längd) och objektets namn . 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. Namnen 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
I det här exemplet visas .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
. Sökvägen använder jokertecknet asterisk (*
) för att ange alla filer med filnamnstillägget .txt
. Parametern Recurse söker i katalogen Path dess underkataloger, som du ser i rubrikerna Katalog: . Parametern Force visar dolda filer, till exempel hiddenfile.txt
som har h-läge.
Exempel 4: Hämta underordnade objekt med hjälp av parametern Include
I det här exemplet Get-ChildItem
används 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 underordnade objekt med parametern Exkludera
I exemplets utdata visas innehållet i katalogen C:\Test\Logs
. Utdata är en referens för de andra kommandona som använder parametrarna Exkludera och Upprepa .
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
exkluderas från utdata.
När parametern Exclude används är en avslutande asterisk (*
) i parametern Path valfri. 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 upprepas kommandot i underkatalogerna för parametern Path . 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 registreringsdatafil
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
. Registreringsdatafilens sökväg och högsta nivå av registernycklar 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 registernyckeln HKLM:\HARDWARE
. Parametern Exclude instruerar Get-ChildItem
att inte 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 kodsigneringsutfärdare
Det här exemplet hämtar varje certifikat på PowerShell-enheten Cert:
som har kodsigneringsutfärdare.
Cmdleten Get-ChildItem
använder parametern Path för att ange certifikatprovidern Cert:
med enheten. Parametern Recurse söker i katalogen som anges av Path och dess underkataloger. Parametern CodeSigningCert hämtar endast certifikat som har kodsigneringsutfärdare.
Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert
Mer information om certifikatprovidern och Cert:
enheten finns i about_Certificate_Provider.
Exempel 8: Hämta objekt med hjälp av parametern Depth
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 har en alternativ vy lagts till för att hämta hårdlänksinformation.
Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink
Exempel 10: Utdata för operativsystem som inte kommer från Windows
I PowerShell 7.1 på Unix-system Get-ChildItem
tillhandahåller 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ändaren är filägare
- Gruppen är gruppens ägare
- Storleken är storleken på filen eller katalogen som representeras i ett Unix-system
Anteckning
Den här funktionen har flyttats från experimentell till vanlig 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 Windows inte något sätt att hämta målinformationen för en AppX-referenspunkt. Egenskaperna LinkTarget och LinkType för filsystemsobjektet är tomma.
Parametrar
-Attributes
Anteckning
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 gör att du kan 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, ReadOnly och System.
Parametern Attribut stöder följande egenskaper:
- Arkiv
- Komprimerade
- Enhet
- Katalog
- Krypterad
- Dold
- IntegrityStream
- Normal
- NoScrubData
- NotContentIndexed
- Offline
- Readonly
- ReparsePoint
- SparseFile
- System
- Tillfälliga
En beskrivning av dessa attribut finns i FileAttributes Enumeration.
Använd följande operatorer för att kombinera attribut:
!
(INTE)+
(OCH),
(ELLER)
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)
Type: | FlagsExpression<T>[FileAttributes] |
Accepted values: | Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CodeSigningCert
Om du vill hämta en lista över certifikat som har Code Signing
i egenskapsvärdet EnhancedKeyUsageList använder du parametern CodeSigningCert .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Depth
Den här parametern lades till i PowerShell 5.0 och gör att du kan kontrollera rekursionsdjupet. Som standard Get-ChildItem
visas innehållet i den överordnade katalogen. Parametern Djup avgör antalet underkatalognivåer som ingår i rekursionen och visar innehållet.
Till exempel -Depth 2
innehåller path-parameterns katalog, den första nivån av underkataloger och den andra nivån av underkataloger. Som standard ingår katalognamn och filnamn i utdata.
Anteckning
På en Windows-dator från PowerShell eller cmd.exekan du visa en grafisk vy över en katalogstruktur med kommandot tree.com .
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Directory
Anteckning
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 Attribut med egenskapen Directory . Du kan använda parametern Recurse med Directory.
Type: | SwitchParameter |
Aliases: | ad |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DnsName
Anger ett domännamn eller namnmönster som matchar egenskapen DNSNameList för certifikat som cmdleten hämtar. Värdet för den här parametern kan vara Unicode
eller ASCII
. Punycode-värden konverteras till Unicode. Jokertecken (*
) tillåts.
Den här parametern återinfördes i PowerShell 7.1
Type: | DnsNameRepresentation |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-DocumentEncryptionCert
Om du vill hämta en lista över certifikat som har Document Encryption
i egenskapsvärdet EnhancedKeyUsageList använder du parametern DocumentEncryptionCert .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Eku
Anger text eller ett textmönster som matchar egenskapen EnhancedKeyUsageList för certifikat som cmdleten hämtar. Jokertecken (*
) tillåts. Egenskapen EnhancedKeyUsageList innehåller det egna namnet och OID-fälten i EKU:n.
Den här parametern återinfördes i PowerShell 7.1
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Anger en matris med ett eller flera strängmönster som ska matchas när cmdleten hämtar underordnade objekt. 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. 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ExpiringInDays
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
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
Anteckning
Den här parametern är endast tillgänglig i FileSystem-providern .
Om du vill hämta en lista över filer använder du filparametern . Du kan använda parametern Recurse med File.
Type: | SwitchParameter |
Aliases: | af |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Låta PowerShell filtrera objekten efter att de har hämtats. Filtersträngen skickas till .NET-API:et för att räkna upp filer. API:et stöder *
endast jokertecken och ?
.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-FollowSymlink
Anteckning
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 de kataloger som är avsedda för 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Hidden
Anteckning
Den här parametern är endast tillgänglig i FileSystem-providern .
Om du bara vill hämta dolda objekt använder du parametern Hidden (Dold ) eller Attributes (Attribut ) med egenskapen Hidden (Dold ). Som standard Get-ChildItem
visas inte dolda objekt. Använd parametern Force för att hämta dolda objekt.
Type: | SwitchParameter |
Aliases: | ah, h |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Anger en matris med ett eller flera strängmönster som ska matchas när cmdleten hämtar underordnade objekt. 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 C:\Windows
katalogen.
Parametrarna Include och Exclude kan användas tillsammans. Undantagen tillämpas dock efter inkluderingarna, vilket kan påverka de slutliga utdata.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 instruerar PowerShell att inte tolka några tecken som escape-sekvenser.
Mer information finns i about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Hämtar bara namnen på objekten på platsen. Utdata är ett strängobjekt som kan skickas ned i pipelinen till andra kommandon. Namnen som returneras är relativa till värdet för parametern Path .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Anger en sökväg till en eller flera platser. Jokertecken accepteras. Standardplatsen är den aktuella katalogen (.
).
Type: | String[] |
Position: | 0 |
Default value: | Current directory |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-ReadOnly
Anteckning
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.
Type: | SwitchParameter |
Aliases: | ar |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recurse
Hämtar objekten på de angivna platserna och i alla underordnade objekt på platserna.
Type: | SwitchParameter |
Aliases: | s |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SSLServerAuthentication
Om du vill hämta en lista över certifikat som har Server Authentication
i egenskapsvärdet EnhancedKeyUsageList använder du parametern SSLServerAuthentication .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-System
Anteckning
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 systemparametern eller attributparameternSystemegenskap.
Type: | SwitchParameter |
Aliases: | as |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.
Utdata
Cmdleten matar ut den här typen vid åtkomst till Alias:
enheten.
Cmdleten matar ut dessa typer vid åtkomst till Cert:
enheten.
Cmdleten matar ut den här typen vid åtkomst till Env:
enheten.
Cmdleten matar ut dessa typer vid åtkomst till Filsystemenheterna.
Cmdleten matar ut dessa typer vid åtkomst till Function:
enheterna.
Cmdleten matar ut den här typen vid åtkomst till registerenheterna.
Cmdleten matar ut den här typen vid åtkomst till Variable:
enheterna.
Cmdleten matar ut dessa typer vid åtkomst till WSMan:
enheterna.
När du använder parametern Namn 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 de leverantörer som är tillgängliga i sessionen skriver du Get-PSProvider
. Mer information finns i about_Providers.