Get-Item

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-Stream <string[]>]
    [<CommonParameters>]

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [-CodeSigningCert]
    [-DocumentEncryptionCert]
    [-SSLServerAuthentication]
    [-DnsName <string>]
    [-Eku <string[]>]
    [-ExpiringInDays <int>]
    [<CommonParameters>]

Get-Item
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<CommonParameters>]

Get-Item
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Force]
    [-Credential <pscredential>]
    [<CommonParameters>]

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.

Det här exemplet 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

Det här exemplet 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

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

Get-Item C:

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

Get-Item C:\*

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.

Det här exemplet 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

Det här exemplet 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\

Det här exemplet hämtar objekt i Windows-katalogen med namn som innehåller en punkt (.), men som inte börjar med w*. Det här exemplet 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*"

I PowerShell 6.2 lades en alternativ vy till för att hämta hårdlänksinformation. Skicka utdata till Format-Table -View childrenWithHardlink för att hämta hårdlänksinformationen

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

Egenskapen Mode identifierar hårdlänken genom l i la---

I PowerShell 7.1 på Unix-system ger cmdleten Get-Item Unix-liknande utdata:

PS> Get-Item /Users

    Directory: /

UnixMode    User  Group   LastWriteTime      Size  Name
--------    ----  -----   -------------      ----  ----
drwxr-xr-x  root  admin   12/20/2019 11:46   192   Users

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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

Vid åtkomst av Cert:-enheten matar cmdleten ut dessa typer.

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

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

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

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

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

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

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

• Alla plattformar:
  • gi

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 om_Leverantörer.