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 名词的 cmdlet (EventLog 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。

通过