Get-Item
Hiermee haalt u het item op de opgegeven locatie op.
Syntaxis
Path (Default) - FileSystem provider
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
LiteralPath - FileSystem provider
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-Stream <string[]>]
[<CommonParameters>]
Path (Default) - Certificate provider
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
LiteralPath - Certificate provider
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]
Path (Default) - All providers
Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]
LiteralPath - All providers
Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]
Description
De Get-Item cmdlet haalt het item op de opgegeven locatie op. De inhoud van het item wordt niet op de locatie weergegeven, tenzij u een jokerteken (*) gebruikt om alle inhoud van het item aan te vragen.
Deze cmdlet wordt gebruikt door PowerShell-providers om door verschillende typen gegevensarchieven te navigeren.
Voorbeelden
Voorbeeld 1: De huidige map ophalen
In dit voorbeeld wordt de huidige map opgeslagen. De punt ('.') vertegenwoordigt het item op de huidige locatie (niet de inhoud).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Voorbeeld 2: alle items in de huidige map ophalen
In dit voorbeeld worden alle items in de huidige map opgeslagen. Het jokerteken (*) vertegenwoordigt alle inhoud van het huidige item.
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
Voorbeeld 3: De huidige map van een station ophalen
In dit voorbeeld wordt de huidige map van de C: schijf opgehaald. Het object dat wordt opgehaald, vertegenwoordigt alleen de map, niet de inhoud ervan.
Get-Item C:
Voorbeeld 4: Items ophalen in het opgegeven station
In dit voorbeeld worden de items van de C: schijf opgehaald. Het jokerteken (*) vertegenwoordigt alle items in de container, niet alleen de container.
Get-Item C:\*
Gebruik in PowerShell één sterretje (*) om inhoud op te halen in plaats van de traditionele *.*. De indeling wordt letterlijk geïnterpreteerd, dus *.* geen mappen of bestandsnamen zonder een punt zou ophalen.
Voorbeeld 5: Een eigenschap verkrijgen in de opgegeven map
In dit voorbeeld wordt de LastAccessTime-eigenschap van de map C:\Windows opgehaald.
LastAccessTime is slechts één eigenschap van bestandssysteemmappen. Als u alle eigenschappen van een map wilt zien, typt u (Get-Item <directory-name>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
Voorbeeld 6: De inhoud van een registersleutel weergeven
In dit voorbeeld ziet u de inhoud van de registersleutel Microsoft.PowerShell. U kunt deze cmdlet gebruiken met de PowerShell-registerprovider om registersleutels en subsleutels op te halen, maar u moet de Get-ItemProperty cmdlet gebruiken om de registerwaarden en -gegevens op te halen.
Get-Item HKLM:\Software\Microsoft\PowerShell\1\Shellids\Microsoft.PowerShell\
Voorbeeld 7: Items ophalen in een map met een uitsluiting
In dit voorbeeld worden items opgeslagen in de Windows-map met namen die een punt (.) bevatten, maar beginnen niet met w*. Dit voorbeeld werkt alleen wanneer het pad een jokerteken (*) bevat om de inhoud van het item op te geven.
Get-Item C:\Windows\*.* -Exclude "w*"
Voorbeeld 8: Gegevens over vaste koppeling ophalen
In PowerShell 6.2 is een alternatieve weergave toegevoegd om hardlinkinformatie op te halen. Als u de gegevens van de hardlink wilt ophalen, sluist u de uitvoer door naar 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
De eigenschap Mode identificeert de vaste koppeling door de l in la---
Voorbeeld 9: Uitvoer voor niet-Windows-besturingssystemen
In PowerShell 7.1 op Unix-systemen biedt de Get-Item cmdlet Unix-achtige uitvoer:
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 Users
De nieuwe eigenschappen die nu deel uitmaken van de uitvoer zijn:
- UnixMode- zijn de bestandsmachtigingen zoals weergegeven op een Unix-systeem
- Gebruiker is de eigenaar van het bestand
- groep is de groepseigenaar
- Grootte de grootte is van het bestand of de map, zoals weergegeven op een Unix-systeem
Opmerking
Deze functie is verplaatst van experimenteel naar basis in PowerShell 7.1.
Parameters
-CodeSigningCert
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Als u certificaten wilt ophalen die in de eigenschapswaarde van Code Signing hebben, gebruikt u de parameter CodeSigningCert.
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Credential
Opmerking
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command-.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | Current user |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-DnsName
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Hiermee geeft u een domeinnaam of naampatroon dat overeenkomt met de eigenschap DNSNameList van certificaten die de cmdlet ophaalt. De waarde van deze parameter kan Unicode of ASCIIzijn. Punycode-waarden worden geconverteerd naar Unicode. Jokertekens (*) zijn toegestaan.
Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | DnsNameRepresentation |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-DocumentEncryptionCert
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Als u certificaten wilt ophalen die Document Encryption in hun EnhancedKeyUsageList eigenschapswaarde hebben, gebruik de parameter DocumentEncryptionCert.
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Eku
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Hiermee geeft u tekst of een tekstpatroon op dat overeenkomt met de eigenschap EnhancedKeyUsageList van certificaten die de cmdlet ophaalt. Jokertekens (*) zijn toegestaan. De eigenschap EnhancedKeyUsageList bevat de gebruiksvriendelijke naam en de OID-velden van de EKU.
Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Exclude
Hiermee specificeert u, als een tekenreeks, één of meerdere items die door deze cmdlet worden uitgesloten van de bewerking. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of patroon in, zoals *.txt. Jokertekens zijn toegestaan. De parameter Uitsluiten is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ExpiringInDays
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Hiermee geeft u op dat de cmdlet alleen certificaten moet retourneren die binnen of vóór het opgegeven aantal dagen verlopen. Een waarde van nul (0) haalt certificaten op die zijn verlopen.
Deze parameter is opnieuw geïntroduceerd in PowerShell 7.1
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Filter
Hiermee geeft u een filter op om de parameter Path te kwalificeren. De FileSystem-provider is de enige geïnstalleerde PowerShell-provider die filters ondersteunt. Filters zijn efficiënter dan andere parameters. De provider past een filter toe wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat deze zijn opgehaald. De filtertekenreeks wordt doorgegeven aan de .NET-API om bestanden op te sommen. De API ondersteunt alleen * en ? jokertekens.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Geeft aan dat deze cmdlet items ophaalt die anders niet kunnen worden geopend, zoals verborgen items. Implementatie varieert van provider tot provider. Zie about_Providersvoor meer informatie. Zelfs met behulp van de Force parameter kan de cmdlet geen beveiligingsbeperkingen overschrijven.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Include
Hiermee specificeert u, in de vorm van een tekenreeksarray, een item of items die deze cmdlet bij de bewerking betrekt. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of patroon in, zoals *.txt. Jokertekens zijn toegestaan. De parameter Opnemen is alleen van kracht wanneer de opdracht de inhoud van een item bevat, zoals C:\Windows\*, waarbij het jokerteken de inhoud van de C:\Windows map aangeeft.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-LiteralPath
Specificeert een pad naar een of meer locaties. De waarde van LiteralPath- wordt precies gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.
Zie about_Quoting_Rulesvoor meer informatie.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | PSPath, LP |
Parametersets
LiteralPath
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Path
Hiermee geeft u het pad naar een item. Met deze cmdlet krijgt u het item op de opgegeven locatie. Jokertekens zijn toegestaan. Deze parameter is vereist, maar de parameternaam Pad is optioneel.
Gebruik een punt (.) om de huidige locatie op te geven. Gebruik het jokerteken (*) om alle items op de huidige locatie op te geven.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
Path
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-SSLServerAuthentication
Dit is een dynamische parameter die beschikbaar wordt gesteld door de Certificate provider. Deze parameter en de Certificate-provider zijn alleen beschikbaar in Windows.
Als u certificaten wilt ophalen die Server Authentication in hun EnhancedKeyUsageList-eigenschapswaarde hebben, gebruikt u de parameter SSLServerAuthentication.
Zie about_Certificate_Providervoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Stream
Dit is een dynamische parameter die beschikbaar wordt gesteld door de FileSystem provider. Deze parameter is alleen beschikbaar in Windows.
Hiermee haalt u de opgegeven alternatieve gegevensstroom op uit het bestand. Voer de naam van de stream in. Wildcards worden ondersteund. Gebruik een sterretje (*) om alle streams op te halen. Deze parameter is geldig voor directory's, maar houd er rekening mee dat directory's niet standaard gegevensstromen hebben.
Deze parameter is geïntroduceerd in PowerShell 3.0. Vanaf PowerShell 7.2 kunnen Get-Item alternatieve gegevensstromen ophalen uit mappen en bestanden.
Zie about_FileSystem_Providervoor meer informatie.
Parametereigenschappen
| Type: | String[] |
| Default value: | No alternate file streams |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.
Uitvoerwaarden
AliasInfo
De cmdlet geeft dit type output bij toegang tot de Alias:-drive.
X509StoreLocation
X509Store
X509Certificate2
De cmdlet geeft deze typen weer bij toegang tot de Cert:-schijf.
DictionaryEntry
De cmdlet geeft dit type output bij toegang tot de Env:-drive.
DirectoryInfo
FileInfo
De cmdlet voert deze typen uit bij het openen van de bestandssysteemstations.
FunctionInfo
FilterInfo
De cmdlet geeft deze typen weer bij toegang tot de Function: stations.
RegistryKey
De cmdlet voert dit type uit bij het benaderen van de registerdrives.
PSVariable
De cmdlet geeft dit type weer bij het benaderen van de Variable:-schijven.
WSManConfigContainerElement
WSManConfigLeafElement
De cmdlet geeft deze typen weer bij toegang tot de WSMan: stations.
Notities
PowerShell bevat de volgende aliassen voor Get-Item:
- Alle platforms:
gi
Deze cmdlet heeft geen parameter Recurse, omdat deze alleen een item krijgt, niet de inhoud ervan.
Gebruik Get-ChildItemom de inhoud van een item recursief op te halen.
Als u door het register wilt navigeren, gebruikt u deze cmdlet om registersleutels en de Get-ItemProperty op te halen om registerwaarden en -gegevens op te halen. De registerwaarden worden beschouwd als eigenschappen van de registersleutel.
Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.
