Write-EventLog

  • Referencia
Modul:
Microsoft.PowerShell.Management

Eseményt ír egy eseménynaplóba.

Syntax

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

Description

A Write-EventLog parancsmag eseményt ír egy eseménynaplóba.

Ha eseményt szeretne írni egy eseménynaplóba, az eseménynaplónak léteznie kell a számítógépen, és a forrásnak regisztrálnia kell az eseménynaplóhoz.

Az EventLog főnevét (az EventLog-parancsmagokat) tartalmazó parancsmagok csak a klasszikus eseménynaplókon működnek. Ha olyan naplókból szeretne eseményeket lekérni, amelyek a Windows Vista és a Windows operációs rendszer újabb verzióiban a Windows eseménynapló technológiáját használják, használja a Get-WinEvent parancsmagot.

Példák

1. példa: Esemény írása az alkalmazás eseménynaplójába

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

Ez a parancs egy eseményt ír a MyApp-forrásból az alkalmazás eseménynaplójába.

2. példa: Esemény írása távoli számítógép alkalmazásesemény-naplójába

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

Ez a parancs egy eseményt ír a MyApp-forrásból az Alkalmazás eseménynaplójába a Server01 távoli számítógépen.

Paraméterek

-Category

Az esemény tevékenységkategóriáját adja meg. Adjon meg egy egész számot, amely az eseménynapló kategóriaüzenetfájljának sztringjeihez van társítva.

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

-ComputerName

Távoli számítógépet ad meg. Alapértelmezés szerint a helyi számítógép.

Írja be egy távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét.

Ez a paraméter nem támaszkodik a Windows PowerShell-újraegyezésre. A parancsmag ComputerName paraméterét Get-EventLog akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

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

-EntryType

Az esemény bejegyzéstípusát adja meg. A paraméter elfogadható értékei a következők: Error, Warning, Information, SuccessAudit és FailureAudit. Az alapértelmezett érték az Információ.

Az értékek leírásáért lásd : EventLogEntryType Enumeration.

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

Megadja az eseményazonosítót. Ez a paraméter kötelező. Az EventId paraméter maximális értéke 65535.

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

-LogName

Annak a naplónak a nevét adja meg, amelyhez az eseményt megírták. Adja meg a napló nevét. A naplónév a Log tulajdonság értéke, nem pedig a LogDisplayName. A helyettesítő karakterek nem engedélyezettek. Ez a paraméter kötelező.

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

-Message

Megadja az eseményüzenetet. Ez a paraméter kötelező.

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

-RawData

Az eseményhez társított bináris adatokat bájtban adja meg.

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

-Source

Megadja az esemény forrását, amely általában annak az alkalmazásnak a neve, amely az eseményt a naplóba írja.

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

Bevitelek

None

Ehhez a parancsmaghoz nem csövezhet be bemenetet.

Kimenetek

EventLogEntry

Ez a parancsmag olyan objektumokat ad vissza, amelyek a naplók eseményeit jelölik.

Jegyzetek

Egyes Windows-eseménynaplók esetében az események írásához rendszergazdai jogosultság szükséges. A PowerShellt a Futtatás Rendszergazda istrator lehetőséggel kell elindítania.