Dela via

Get-Item

  • Referens
Modul:
Microsoft.PowerShell.Management

Hämtar objektet på den angivna platsen.

Syntax

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

Cmdleten Get-Item hämtar objektet på den angivna platsen. Det hämtar inte innehållet i objektet på platsen om du inte använder ett jokertecken ('*') för att begära allt innehåll i objektet.

Den här cmdleten används av PowerShell-leverantörer för att navigera genom olika typer av datalager.

Exempel

Exempel 1: Hämta den aktuella katalogen

Det här kommandot hämtar den aktuella katalogen. Punkten ('.') representerar objektet på den aktuella platsen (inte dess innehåll).

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Exempel 2: Hämta alla objekt i den aktuella katalogen

Det här kommandot hämtar alla objekt i den aktuella katalogen. Jokertecknet ('*') representerar allt innehåll i det aktuella objektet.

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

Exempel 3: Hämta den aktuella katalogen för en enhet

Det här kommandot hämtar den aktuella katalogen för C:-enheten. Objektet som hämtas representerar bara katalogen, inte dess innehåll.

Get-Item C:\

Exempel 4: Hämta objekt på den angivna enheten

Det här kommandot hämtar objekten i C:-enheten. Jokertecknet ('*') representerar alla objekt i containern, inte bara containern.

I PowerShell använder du en enda asterisk ("") för att hämta innehåll, i stället för den traditionella ".". Formatet tolkas bokstavligen, så ".*" skulle inte hämta kataloger eller filnamn utan en punkt.

Get-Item C:\*

Exempel 5: Hämta en egenskap i den angivna katalogen

Det här kommandot hämtar egenskapen LastAccessTime för katalogen "C:\Windows". LastAccessTime är bara en egenskap för filsystemkataloger. Om du vill se alla egenskaper för en katalog skriver du (Get-Item \<directory-name\>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

Exempel 6: Visa innehållet i en registernyckel

Det här kommandot visar innehållet i Microsoft.PowerShell registernyckel. Du kan använda den här cmdleten med PowerShell-registerprovidern för att hämta registernycklar och undernycklar, men du måste använda cmdleten Get-ItemProperty för att hämta registervärden och data.

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Exempel 7: Hämta objekt i en katalog som har ett undantag

Det här kommandot hämtar objekt i Windows-katalogen med namn som innehåller en punkt ('.'), men börjar inte med "w*". Det här kommandot fungerar bara när sökvägen innehåller ett jokertecken ('*') för att ange innehållet i objektet.

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

Parametrar

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standardvärdet är den aktuella användaren.

Ange ett användarnamn, till exempel "User01" eller "Domain01\User01", eller ange ett PSCredential- objekt, till exempel ett som genereras av Get-Credential cmdlet. Om du skriver ett användarnamn uppmanas du att ange ett lösenord.

Varning

Den här parametern stöds inte av några leverantörer som är installerade med Windows PowerShell.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Exclude

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten exkluderar i åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel "*.txt". Jokertecken tillåts.

Parametern Exclude 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".

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

-Filter

Anger ett filter i providerns format eller språk. Värdet för den här parametern kvalificerar parametern Path.

Syntaxen för filtret, inklusive användningen av jokertecken, beror på providern. Filter är effektivare än andra parametrar eftersom providern tillämpar dem när cmdleten hämtar objekten i stället för att Låta PowerShell filtrera objekten när de har hämtats.

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

-Force

Anger att denna cmdlet hämtar objekt som annars inte kan nås, till exempel dolda objekt. Implementeringen varierar från leverantör till leverantör. Mer information finns i about_Providers. Även om du använder parametern Force kan cmdleten inte åsidosätta säkerhetsbegränsningar.

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

-Include

Anger, som en strängmatris, ett objekt eller objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Path. 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".

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 objektet. Till skillnad från parametern Path används värdet för LiteralPath precis 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.

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

-Path

Anger sökvägen till ett objekt. Den här cmdleten hämtar objektet på den angivna platsen. Jokertecken tillåts. Den här parametern krävs, men parameternamnet ("Sökväg") är valfritt.

Använd en punkt ('.') för att ange den aktuella platsen. Använd jokertecknet ('*') för att ange alla objekt på den aktuella platsen.

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

-Stream

Hämtar den angivna alternativa NTFS-filströmmen från filen. Ange streamnamnet. Jokertecken stöds. Om du vill hämta alla strömmar använder du en asterisk (*). Den här parametern är inte giltig för mappar.

Stream är en dynamisk parameter som FileSystem-providern lägger till i cmdleten Get-Item. Den här parametern fungerar bara på filsystemenheter.

Typ:String[]
Position:Named
Standardvärde:No alternate file streams
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
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

Object

Den här cmdleten returnerar de objekt som den får. Typen bestäms av typen av objekt i sökvägen.

Kommentarer

Den här cmdleten har ingen Recurse parameter, eftersom den bara hämtar ett objekt, inte dess innehåll. Om du vill hämta innehållet i ett objekt rekursivt använder du Get-ChildItem.

Om du vill navigera i registret använder du den här cmdleten för att hämta registernycklar och Get-ItemProperty för att hämta registervärden och data. Registervärdena anses vara egenskaper för registernyckeln.

Den här cmdleten ä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.