Compartilhar via

Write-EventLog

  • Referência
Módulo:
Microsoft.PowerShell.Management

Grava um evento em um log de eventos.

Syntax

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

Description

O Write-EventLog cmdlet grava um evento em um log de eventos.

Para gravar um evento em um log de eventos, o log de eventos deve existir no computador, e a origem deve ser registrada para o log de eventos.

Os cmdlets que contêm o substantivo EventLog (os cmdlets EventLog ) funcionam somente em logs de eventos clássicos. Para obter eventos de logs que usam a tecnologia de Log de Eventos do Windows no Windows Vista e em versões posteriores do sistema operacional Windows, use o Get-WinEvent cmdlet.

Exemplos

Exemplo 1: Gravar um evento no log de eventos do aplicativo

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

Este comando grava um evento no log de eventos de aplicativo da origem MyApp.

Exemplo 2: Gravar um evento no log de eventos do aplicativo de um computador remoto

PS C:\> Write-EventLog -ComputerName "Server01" -LogName Application -Source "MyApp" -EventID 3001 -Message "MyApp added a user-requested feature to the display."

Este comando grava um evento da origem MyApp no log de eventos do aplicativo no computador remoto Server01.

Parâmetros

-Category

Especifica uma categoria de tarefa para o evento. Insira um número inteiro que está associado às cadeias de caracteres no arquivo de mensagem de categoria para o log de eventos.

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

-ComputerName

Especifica um computador remoto. O padrão é o computador local.

Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um computador remoto.

Esse parâmetro não depende da comunicação remota do Windows PowerShell. Você pode usar o parâmetro ComputerName do cmdlet mesmo se o Get-EventLog computador não estiver configurado para executar comandos remotos.

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

-EntryType

Especifica o tipo de entrada do evento. Os valores aceitáveis para esse parâmetro são: Error, Warning, Information, SuccessAudit e FailureAudit. O valor padrão é Information.

Para obter uma descrição dos valores, consulte Enumeração 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

Especifica o identificador do evento. Este parâmetro é obrigatório. O valor máximo para o parâmetro EventId é 65535.

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

-LogName

Especifica o nome do log no qual o evento será gravado. Insira o nome do log. O nome do log é o valor da propriedade Log , não o LogDisplayName. Caracteres curinga não são permitidos. Este parâmetro é obrigatório.

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

-Message

Especifica a mensagem do evento. Este parâmetro é obrigatório.

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

-RawData

Especifica os dados binários associados ao evento, em bytes.

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

-Source

Especifica a origem do evento, que normalmente é o nome do aplicativo que está gravando o evento no log.

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

Entradas

None

Não é possível redirecionar a entrada para este cmdlet.

Saídas

EventLogEntry

Esse cmdlet retorna objetos que representam os eventos nos logs.

Observações

Para alguns logs de eventos do Windows, a gravação de eventos requer direitos de administrador. Você deve iniciar o PowerShell usando a opção Executar como administrador .