Write-EventLog

参考

模块:: Microsoft.PowerShell.Management

将事件写入事件日志。

语法

Write-EventLog
     [-LogName] <String>
     [-Source] <String>
     [[-EntryType] <EventLogEntryType>]
     [-Category <Int16>]
     [-EventId] <Int32>
     [-Message] <String>
     [-RawData <Byte[]>]
     [-ComputerName <String>]
     [<CommonParameters>]

说明

Write-EventLog cmdlet 将事件写入事件日志。

若要将事件写入事件日志，事件日志必须存在于计算机上，并且必须为事件日志注册源。

包含 EventLog 名词（EventLog cmdlet）的 cmdlet 仅适用于经典事件日志。若要从 Windows Vista 和更高版本的 Windows作系统中使用 Windows 事件日志技术的日志获取事件，请使用 Get-WinEvent cmdlet。

示例

示例 1：将事件写入应用程序事件日志

PS C:\> Write-EventLog -LogName "Application" -Source "MyApp" -EventID 3001 -EntryType Information -Message "MyApp added a user-requested feature to the display." -Category 1 -RawData 10,20

此命令将来自 MyApp 源的事件写入应用程序事件日志。

示例 2：将事件写入远程计算机的应用程序事件日志

PS C:\> Write-EventLog -ComputerName "Server01" -LogName Application -Source "MyApp" -EventID 3001 -Message "MyApp added a user-requested feature to the display."

此命令将来自 MyApp 源的事件写入 Server01 远程计算机上的应用程序事件日志。

参数

-Category

指定事件的任务类别。输入与事件日志类别消息文件中的字符串关联的整数。

类型:	Int16
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ComputerName

指定远程计算机。默认值为本地计算机。

键入 NetBIOS 名称、IP 地址或远程计算机的完全限定域名。

此参数不依赖于 Windows PowerShell 远程处理。即使计算机未配置为运行远程命令，也可以使用 Get-EventLog cmdlet 的 ComputerName 参数。

类型:	String
别名:	CN
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EntryType

指定事件的条目类型。此参数的可接受值为：Error、Warning、Information、SuccessAudit 和 FailureAudit。默认值为 Information。

有关值的说明，请参阅 EventLogEntryType 枚举。

类型:	EventLogEntryType
别名:	ET
接受的值:	Error, Information, FailureAudit, SuccessAudit, Warning
Position:	3
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EventId

指定事件标识符。此参数是必需的。 EventId 参数的最大值为 65535。

类型:	Int32
别名:	ID, EID
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-LogName

指定写入事件的日志的名称。输入日志名称。日志名称是 Log 属性的值，而不是 LogDisplayName的值。不允许使用通配符。此参数是必需的。

类型:	String
别名:	LN
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Message

指定事件消息。此参数是必需的。

类型:	String
别名:	MSG
Position:	4
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RawData

指定与事件关联的二进制数据（以字节为单位）。

类型:	Byte[]
别名:	RD
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Source

指定事件源，该源通常是将事件写入日志的应用程序的名称。

类型:	String
别名:	SRC
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

EventLogEntry

此 cmdlet 返回表示日志中的事件的对象。

备注

对于某些 Windows 事件日志，写入事件需要管理员权限。必须使用 以管理员身份运行 选项启动 PowerShell。

通过