Share via

Write-EventLog

  • 참조
모듈:
Microsoft.PowerShell.Management

이벤트 로그에 이벤트를 씁니다.

Syntax

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

Description

cmdlet은 Write-EventLog 이벤트 로그에 이벤트를 씁니다.

이벤트 로그에 이벤트를 쓰려면 이벤트 로그가 컴퓨터에 있어야 하며 이벤트 로그에 대한 원본을 등록해야 합니다.

EventLog 명사(EventLog cmdlet)를 포함하는 cmdlet은 클래식 이벤트 로그에서만 작동합니다. Windows Vista 이상 버전의 Windows 운영 체제에서 Windows 이벤트 로그 기술을 사용하는 로그에서 이벤트를 얻으려면 cmdlet을 Get-WinEvent 사용합니다.

예제

예제 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

이벤트의 작업 범주를 지정합니다. 이벤트 로그에 대한 범주 메시지 파일의 문자열과 연결된 정수를 입력합니다.

Type:Int16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

원격 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다.

원격 컴퓨터의 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력하세요.

이 매개 변수는 Windows PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 cmdlet의 Get-EventLog ComputerName 매개 변수를 사용할 수 있습니다.

Type:String
Aliases:CN
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EntryType

이벤트의 항목 유형을 지정합니다. 이 매개 변수에 허용되는 값은 오류, 경고, 정보, SuccessAudit 및 FailureAudit입니다. 기본값은 Information입니다.

값에 대한 설명은 EventLogEntryType 열거형을 참조 하세요.

Type:EventLogEntryType
Aliases:ET
Accepted values:Error, Information, FailureAudit, SuccessAudit, Warning
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventId

이벤트 식별자를 지정합니다. 이 매개 변수는 필수입니다. EventId 매개 변수의 최대값은 65535입니다.

Type:Int32
Aliases:ID, EID
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogName

이벤트가 기록되는 로그의 이름을 지정합니다. 로그 이름을 입력합니다. 로그 이름은 LogDisplayName이 아닌 Log 속성의 값입니다. 와일드카드 문자는 허용되지 않습니다. 이 매개 변수는 필수입니다.

Type:String
Aliases:LN
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Message

이벤트 메시지를 지정합니다. 이 매개 변수는 필수입니다.

Type:String
Aliases:MSG
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RawData

이벤트와 연결된 이진 데이터를 바이트 단위로 지정합니다.

Type:Byte[]
Aliases:RD
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

일반적으로 로그에 이벤트를 쓰는 애플리케이션의 이름인 이벤트 원본을 지정합니다.

Type:String
Aliases:SRC
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

EventLogEntry

이 cmdlet은 로그의 이벤트를 나타내는 개체를 반환합니다.

참고

일부 Windows 이벤트 로그의 경우 이벤트를 작성하려면 관리자 권한이 필요합니다. 실행 관리istrator 옵션을 사용하여 PowerShell을 시작해야 합니다.