Sdílet prostřednictvím

Write-EventLog

  • Reference
Modul:
Microsoft.PowerShell.Management

Zapíše událost do protokolu událostí.

Syntaxe

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

Description

Rutina Write-EventLog zapíše událost do protokolu událostí.

Pokud chcete napsat událost do protokolu událostí, musí protokol událostí existovat v počítači a zdroj musí být zaregistrovaný pro protokol událostí.

Rutiny, které obsahují EventLog podstatné jméno (rutiny EventLog), fungují pouze v klasických protokolech událostí. Pokud chcete získat události z protokolů, které používají technologii protokolu událostí systému Windows ve Windows Vista a novějších verzích operačního systému Windows, použijte rutinu Get-WinEvent.

Příklady

Příklad 1: Zápis události do protokolu událostí aplikace

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

Tento příkaz zapíše událost ze zdroje MyApp do protokolu událostí aplikace.

Příklad 2: Zápis události do protokolu událostí aplikace vzdáleného počítače

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

Tento příkaz zapíše událost ze zdroje MyApp do protokolu událostí aplikace na vzdáleném počítači Serveru01.

Parametry

-Category

Určuje kategorii úkolu pro událost. Zadejte celé číslo, které je přidruženo k řetězcům v souboru zprávy kategorie pro protokol událostí.

Typ:Int16
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ComputerName

Určuje vzdálený počítač. Výchozí hodnota je místní počítač.

Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény vzdáleného počítače.

Tento parametr nespoléhá na vzdálené komunikace Windows PowerShellu. Parametr ComputerName rutiny Get-EventLog můžete použít i v případě, že váš počítač není nakonfigurovaný pro spouštění vzdálených příkazů.

Typ:String
Aliasy:CN
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EntryType

Určuje typ položky události. Přijatelné hodnoty pro tento parametr jsou: Error, Warning, Information, SuccessAudit a FailureAudit. Výchozí hodnota je Informace.

Popis hodnot najdete v tématu EventLogEntryType – výčet v knihovně MSDN.

Typ:EventLogEntryType
Aliasy:ET
Přípustné hodnoty:Error, Information, FailureAudit, SuccessAudit, Warning
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventId

Určuje identifikátor události. Tento parametr je povinný. Maximální hodnota parametru EventId je 65535.

Typ:Int32
Aliasy:ID, EID
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LogName

Určuje název protokolu, do kterého je událost zapsána. Zadejte název protokolu. Název protokolu je hodnota vlastnosti Log, nikoli LogDisplayName. Zástupné znaky nejsou povoleny. Tento parametr je povinný.

Typ:String
Aliasy:LN
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Message

Určuje zprávu události. Tento parametr je povinný.

Typ:String
Aliasy:MSG
Position:4
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RawData

Určuje binární data přidružená k události v bajtech.

Typ:Byte[]
Aliasy:RD
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Source

Určuje zdroj událostí, což je obvykle název aplikace, která zapisuje událost do protokolu.

Typ:String
Aliasy:SRC
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

EventLogEntry

Tato rutina vrací objekty, které představují události v protokolech.

Poznámky

  • Pokud chcete použít write-EventLog , spusťte Windows PowerShell pomocí možnosti Spustit jako správce.