Write-EventLog
將事件寫入事件記錄檔。
語法
Write-EventLog
[-LogName] <String>
[-Source] <String>
[[-EntryType] <EventLogEntryType>]
[-Category <Int16>]
[-EventId] <Int32>
[-Message] <String>
[-RawData <Byte[]>]
[-ComputerName <String>]
[<CommonParameters>] Description
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。
如需值的描述，請參閱 MSDN 連結庫中的 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。
輸出
此 Cmdlet 會傳回代表記錄中事件的物件。
備註
若要使用 Write-EventLog，請使用 [以系統管理員身分執行] 選項啟動 Windows PowerShell。