Write-EventLog
이벤트 로그에 이벤트를 씁니다.
구문
Default (기본값)
Write-EventLog
[-LogName] <String>
[-Source] <String>
[[-EntryType] <EventLogEntryType>]
[-Category <Int16>]
[-EventId] <Int32>
[-Message] <String>
[-RawData <Byte[]>]
[-ComputerName <String>]
[<CommonParameters>]
Description
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 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ComputerName
원격 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.
원격 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다.
이 매개 변수는 Windows PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 Get-EventLog cmdlet의 ComputerName 매개 변수를 사용할 수 있습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 중국 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-EntryType
이벤트의 항목 유형을 지정합니다. 이 매개 변수에 허용되는 값은 오류, 경고, 정보, SuccessAudit 및 FailureAudit입니다. 기본값은 Information입니다.
값에 대한 설명은 MSDN 라이브러리의 EventLogEntryType 열거형 참조하세요.
매개 변수 속성
| 형식: | EventLogEntryType |
| Default value: | None |
| 허용되는 값: | Error, Information, FailureAudit, SuccessAudit, Warning |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 동부 시간 |
매개 변수 집합
(All)
| Position: | 3 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-EventId
이벤트 식별자를 지정합니다. 이 매개 변수는 필수입니다. EventId 매개 변수의 최대값은 65535입니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 아이디, EID |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-LogName
이벤트가 기록되는 로그의 이름을 지정합니다. 로그 이름을 입력합니다. 로그 이름은 LogDisplayName아니라 Log 속성의 값입니다. 와일드카드 문자는 허용되지 않습니다. 이 매개 변수는 필수입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | LN |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Message
이벤트 메시지를 지정합니다. 이 매개 변수는 필수입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 메시지 |
매개 변수 집합
(All)
| Position: | 4 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RawData
이벤트와 연결된 이진 데이터를 바이트 단위로 지정합니다.
매개 변수 속성
| 형식: | Byte[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | RD |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Source
일반적으로 로그에 이벤트를 쓰는 애플리케이션의 이름인 이벤트 원본을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | SRC |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
None
이 cmdlet에 입력을 파이프할 수 없습니다.
출력
EventLogEntry
이 cmdlet은 로그의 이벤트를 나타내는 개체를 반환합니다.
참고
Write-EventLog
사용하려면 관리자 권한으로 실행 옵션을 사용하여 Windows PowerShell을 시작합니다.