Show-Eventlog
Applies To: Windows PowerShell 2.0
Displays the event logs of the local or a remote computer in Event Viewer.
Syntax
Show-EventLog [[-ComputerName] <string>] [<CommonParameters>]
Description
The Show-EventLog cmdlet opens Event Viewer on the local computer and displays in it all of the classic event logs on the local computer or a remote computer.
To open Event Viewer on Windows Vista and later versions of Windows, the current user must be a member of the Administrators group on the local computer.
The cmdlets that contain the EventLog noun (the EventLog cmdlets) work only on classic event logs. To get events from logs that use the Windows Event Log technology in Windows Vista and later versions of Windows, use Get-WinEvent.
Parameters
-ComputerName <string>
Specifies a remote computer. Show-EventLog displays the event logs from the specified computer in Event Viewer on the local computer. The default is the local computer.
Type the NetBIOS name, an Internet Protocol (IP) address, or a fully qualified domain name of a remote computer.
This parameter does not rely on Windows PowerShell remoting. You can use the ComputerName parameter of Get-EventLog even if your computer is not configured to run remote commands.
Required? |
false |
Position? |
1 |
Default Value |
. |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This command supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see about_CommonParameters.
Inputs and Outputs
The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet returns.
Inputs |
None You cannot pipe input to this cmdlet. |
Outputs |
None This cmdlet does not generate any output. |
Notes
The Windows PowerShell command prompt returns as soon as Event Viewer opens. You can work in the current session while Event Viewer is open.
Because this cmdlet requires a user interface, it does not work on Server Core installations of Windows Server.
Example 1
C:\PS>show-eventlog
Description
-----------
This command opens Event Viewer and displays in it the classic event logs on the local computer.
Example 2
C:\PS>show-eventlog -computername Server01
Description
-----------
This command opens Event Viewer and displays in it the classic event logs on the Server01 computer.
See Also
Concepts
Clear-EventLog
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Write-EventLog
Get-WinEvent