Bagikan melalui

Get-Error

Modul:
Microsoft.PowerShell.Utility Module

Mendapatkan dan menampilkan pesan kesalahan terbaru dari sesi saat ini.

Sintaks

Newest (Default) 

Get-Error
    [[-Newest] <Int32>]
    [<CommonParameters>]

Error 

Get-Error
    [-InputObject <PSObject>]
    [<CommonParameters>]

Deskripsi

Cmdlet Get-Error mendapatkan objek PSExtendedError yang mewakili detail kesalahan saat ini dari kesalahan terakhir yang terjadi dalam sesi.

Anda dapat menggunakan Get-Error untuk menampilkan sejumlah kesalahan tertentu yang telah terjadi dalam sesi saat ini menggunakan parameter terbaru.

Cmdlet Get-Error juga menerima objek kesalahan dari koleksi, seperti $Error, untuk menampilkan beberapa kesalahan dari sesi saat ini.

Contoh

Contoh 1: Dapatkan detail kesalahan terbaru

Dalam contoh ini, Get-Error menampilkan detail kesalahan terbaru yang terjadi dalam sesi saat ini.

Get-ChildItem -Path /NoRealDirectory
Get-Error

Get-ChildItem: Cannot find path 'C:\NoRealDirectory' because it does not exist.

Exception             :
    ErrorRecord          :
        Exception             :
            Message : Cannot find path 'C:\NoRealDirectory' because it does not exist.
            HResult : -2146233087
        TargetObject          : C:\NoRealDirectory
        CategoryInfo          : ObjectNotFound: (C:\NoRealDirectory:String) [], ParentContainsErrorRecordException
        FullyQualifiedErrorId : PathNotFound
    ItemName             : C:\NoRealDirectory
    SessionStateCategory : Drive
    TargetSite           :
        Name          : GetChildItems
        DeclaringType : System.Management.Automation.SessionStateInternal
        MemberType    : Method
        Module        : System.Management.Automation.dll
    StackTrace           :
   at System.Management.Automation.SessionStateInternal.GetChildItems(String path, Boolean recurse, UInt32 depth,
CmdletProviderContext context)
   at System.Management.Automation.ChildItemCmdletProviderIntrinsics.Get(String path, Boolean recurse, UInt32
depth, CmdletProviderContext context)
   at Microsoft.PowerShell.Commands.GetChildItemCommand.ProcessRecord()
    Message              : Cannot find path 'C:\NoRealDirectory' because it does not exist.
    Source               : System.Management.Automation
    HResult              : -2146233087
TargetObject          : C:\NoRealDirectory
CategoryInfo          : ObjectNotFound: (C:\NoRealDirectory:String) [Get-ChildItem], ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,Microsoft.PowerShell.Commands.GetChildItemCommand
InvocationInfo        :
    MyCommand        : Get-ChildItem
    ScriptLineNumber : 1
    OffsetInLine     : 1
    HistoryId        : 57
    Line             : Get-ChildItem -Path C:\NoRealDirectory
    PositionMessage  : At line:1 char:1
                       + Get-ChildItem -Path C:\NoRealDirectory
                       + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    InvocationName   : Get-ChildItem
    CommandOrigin    : Internal
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo :

Contoh 2: Dapatkan jumlah pesan kesalahan yang ditentukan yang terjadi dalam sesi saat ini

Contoh ini menunjukkan cara menggunakan Get-Error dengan parameter terbaru. Dalam contoh ini, Terbaru mengembalikan detail 3 kesalahan terbaru yang terjadi dalam sesi ini.

Get-Error -Newest 3

Contoh 3: Mengirim kumpulan kesalahan untuk menerima pesan terperinci

Variabel otomatis $Error berisi array objek kesalahan dalam sesi saat ini. Array objek dapat disalurkan ke Get-Error untuk menerima pesan kesalahan terperinci.

Dalam contoh ini, $Error disalurkan ke cmdlet Get-Error. hasilnya adalah daftar pesan kesalahan terperinci, mirip dengan hasil Contoh 1.

$Error | Get-Error

Parameter

-InputObject

Parameter ini digunakan untuk input alur.

Properti parameter

Jenis:PSObject
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Error
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Newest

Menentukan jumlah kesalahan yang akan ditampilkan yang terjadi dalam sesi saat ini.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Terakhir

Set parameter

Newest
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSObject

Anda dapat menyalurkan PSObject ke cmdlet ini, tetapi hasilnya bervariasi kecuali jika ErrorRecord atau objek Pengecualian disediakan.

Output

ErrorRecord

Cmdlet ini mengembalikan objek PSExtendedError.

Catatan

PowerShell menyertakan alias berikut untuk Get-Error:

  • Semua platform:
    • gerr

Get-Error menerima input alur. Contohnya, $Error | Get-Error.