Get-Item

Module:

Microsoft.PowerShell.Management

Hiermee haalt u het item op de opgegeven locatie op.

Syntaxis

Get-Item
   [-Path] <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<CommonParameters>]

Get-Item
   -LiteralPath <String[]>
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Force]
   [-Credential <PSCredential>]
   [-UseTransaction]
   [-Stream <String[]>]
   [<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

Met deze opdracht wordt de huidige map ophaalt. 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

Met deze opdracht 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

Met deze opdracht wordt de huidige map van het station C: ophaalt. Het object dat wordt opgehaald, vertegenwoordigt alleen de map, niet de inhoud ervan.

Get-Item C:\

Voorbeeld 4: Items ophalen in het opgegeven station

Met deze opdracht worden de items in het station C: opgeslagen. Het jokerteken ('*') vertegenwoordigt alle items in de container, niet alleen de container.

Gebruik in PowerShell één sterretje ('') om inhoud op te halen, in plaats van de traditionele '.". De indeling wordt letterlijk geïnterpreteerd, dus '.*' haalt geen mappen of bestandsnamen op zonder punt.

Get-Item C:\*

Voorbeeld 5: Een eigenschap ophalen in de opgegeven map

Met deze opdracht wordt de eigenschap LastAccessTime 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

Met deze opdracht wordt de inhoud van de registersleutel Microsoft.PowerShell weergegeven. 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

Met deze opdracht worden items in de Windows-map opgehaald met namen die een punt ('.'), maar niet beginnen met 'w*'. Deze opdracht werkt alleen wanneer het pad een jokerteken ('*') bevat om de inhoud van het item op te geven.

Get-Item c:\Windows\*.* -Exclude "w*"

Parameters

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is de huidige gebruiker.

Typ een gebruikersnaam, zoals 'User01' of 'Domain01\User01', of voer een PSCredential--object in, zoals een object dat is gegenereerd door de Get-Credential-cmdlet. Als u een gebruikersnaam typt, wordt u om een wachtwoord gevraagd.

Waarschuwing

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met Windows PowerShell.

Type:	PSCredential
Position:	Named
Default value:	Current user
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Exclude

Hiermee geeft u, als een tekenreeksmatrix, een item of items op die door deze cmdlet worden uitgesloten in 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 map C:\Windows aangeeft.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-Filter

Hiermee geeft u een filter in de indeling of taal van de provider. De waarde van deze parameter komt in aanmerking voor de parameter Path.

De syntaxis van het filter, inclusief het gebruik van jokertekens, is afhankelijk van de provider. Filters zijn efficiënter dan andere parameters, omdat de provider deze toepast wanneer de cmdlet de objecten ophaalt in plaats van PowerShell de objecten te filteren nadat ze zijn opgehaald.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-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 als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen overschrijven.

Type:	SwitchParameter
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Include

Hiermee geeft u, als tekenreeksmatrix, een item of items op die deze cmdlet in de bewerking bevat. De waarde van deze parameter komt in aanmerking voor de parameter Path. Voer een padelement of -patroon in, zoals '*.txt'. Jokertekens zijn toegestaan.

De 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 map C:\Windows aangeeft.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-LiteralPath

Hiermee geeft u een pad naar het item. In tegenstelling tot de parameter Path, wordt de waarde van LiteralPath- exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:	String[]
Aliassen:	PSPath
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Path

Hiermee geeft u het pad naar een item. Met deze cmdlet wordt het item op de opgegeven locatie opgeslagen. 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.

Type:	String[]
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	True

-Stream

Hiermee haalt u de opgegeven alternatieve NTFS-bestandsstroom op uit het bestand. Voer de naam van de stream in. Jokertekens worden ondersteund. Als u alle streams wilt ophalen, gebruikt u een sterretje (*). Deze parameter is niet geldig voor mappen.

Stream is een dynamische parameter die de FileSystem-provider toevoegt aan de Get-Item-cmdlet. Deze parameter werkt alleen in bestandssysteemstations.

Type:	String[]
Position:	Named
Default value:	No alternate file streams
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	True

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:	SwitchParameter
Aliassen:	usetx
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

Object

Met deze cmdlet worden de objecten geretourneerd die worden opgehaald. Het type wordt bepaald door het type objecten in het pad.

Notities

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.

Verwante koppelingen

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider