Write-EventLog
이벤트 로그에 이벤트를 기록합니다.
구문
Write-EventLog [-LogName] <string> [-Source] <string> [-EventID] <int> [-Message] <string> [[-EntryType] {<Error> | <Warning> | <Information> | <SuccessAudit> | <FailureAudit>}] [-Category <Int16>] [-ComputerName <string>] [-RawData <Byte[]>] [<CommonParameters>]
설명
Write-EventLog cmdlet은 이벤트 로그에 이벤트를 씁니다.
이벤트 로그에 이벤트를 쓰려면 컴퓨터에 이벤트 로그가 있고 원본이 이벤트 로그에 등록되어야 합니다.
EventLog 명사(EventLog cmdlet)를 포함하는 cmdlet은 기본 이벤트 로그에서만 작동합니다. Windows Vista 이상에서 Windows 이벤트 로그 기술을 사용하는 로그로부터 이벤트를 가져오려면 Get-WinEvent를 사용합니다.
매개 변수
-Category <Int16>
이벤트의 작업 범주를 지정합니다. 이벤트 로그의 범주 메시지 파일에 있는 문자열과 연결된 정수를 입력합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
1 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-ComputerName <string>
원격 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.
원격 컴퓨터의 NetBIOS 이름, IP(인터넷 프로토콜) 주소 또는 정규화된 도메인 이름을 입력합니다.
이 매개 변수는 Windows PowerShell 원격에 독립적입니다. 원격 명령을 실행하도록 컴퓨터를 구성하지 않은 경우에도 Get-EventLog의 ComputerName 매개 변수를 사용할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-EntryType <EventLogEntryType>
이벤트의 항목 유형을 지정합니다. 유효한 값은 Error, Warning, Information, SuccessAudit 및 FailureAudit입니다. 기본값은 Information입니다.
값에 대한 설명은 MSDN(Microsoft Developer Network) 라이브러리의 System.Diagnostics.EventLogEntryType(https://go.microsoft.com/fwlink/?LinkId=143599)을 참조하십시오.
필수 여부 |
false |
위치 |
4 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-EventID <int>
이벤트 식별자를 지정합니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
3 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-LogName <string>
이벤트가 기록되는 로그의 이름을 지정합니다. 로그 이름(LogDisplayName이 아닌 Log 속성의 값)을 입력합니다. 와일드카드 문자는 사용할 수 없습니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Message <string>
이벤트 메시지를 지정합니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
5 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-RawData <Byte[]>
이벤트와 연결된 이진 데이터를 바이트 단위로 지정합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Source <string>
이벤트 원본을 지정합니다. 이는 일반적으로 로그에 이벤트를 기록하는 응용 프로그램의 이름입니다.
필수 여부 |
true |
위치 |
2 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
출력 |
System.Diagnostics.EventLogEntry Write-EventLog는 로그의 이벤트를 나타내는 개체를 반환합니다. |
참고
Windows Vista 이상에서 Write-EventLog를 사용하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작합니다.
예 1
C:\PS>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 원본의 이벤트를 Application 이벤트 로그에 씁니다.
예 2
C:\PS>write-eventlog -computername Server01 -logname Application -source MyApp -eventID 3001 -message "MyApp added a user-requested feature to the display."
설명
-----------
이 명령은 MyApp 원본의 이벤트를 Server01 원격 컴퓨터의 Application 이벤트 로그에 씁니다.
참고 항목
개념
Clear-EventLog
Get-EventLog
Limit-EventLog
New-EventLog
Remove-EventLog
Show-EventLog
Write-EventLog
Get-WinEvent