Write-EventLog
Zapíše událost do protokolu událostí.
Syntax
Default (Výchozí)
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í.
Vlastnosti parametru
| Typ: | Int16 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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ů.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Čína |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 naleznete v tématu EventLogEntryType Výčet.
Vlastnosti parametru
| Typ: | EventLogEntryType |
| Default value: | None |
| Přípustné hodnoty: | Error, Information, FailureAudit, SuccessAudit, Warning |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | ET |
Sady parametrů
(All)
| Position: | 3 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-EventId
Určuje identifikátor události. Tento parametr je povinný. Maximální hodnota parametru EventId je 65535.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | ID, EID |
Sady parametrů
(All)
| Position: | 2 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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ý.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | LN |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Message
Určuje zprávu události. Tento parametr je povinný.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Glutamát sodný |
Sady parametrů
(All)
| Position: | 4 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RawData
Určuje binární data přidružená k události v bajtech.
Vlastnosti parametru
| Typ: | Byte[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Rodinný dům |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Source
Určuje zdroj událostí, což je obvykle název aplikace, která zapisuje událost do protokolu.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | SRC |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
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
U některých protokolů událostí Systému Windows vyžaduje zápis událostí práva správce. PowerShell musíte spustit pomocí možnosti Spustit jako správce.
