winlog: improve documentation for obtaining channel names (#5689)

Author: efd6

packages/winlog/_dev/build/docs/README.md

@@ -1,10 +1,9 @@
 # Custom Windows event log package
 
-The custom Windows event log package allows you to ingest events from
-any [Windows event log](https://docs.microsoft.com/en-us/windows/win32/wes/windows-event-log) channel.  You can get a list of available event
-log channels by running `Get-EventLog *` in PowerShell.  Custom ingest
-pipelines may be added by setting one up in
-[Ingest Node Pipelines](/app/management/ingest/ingest_pipelines/).
+The custom Windows event log package allows you to ingest events from any [Windows event log](https://docs.microsoft.com/en-us/windows/win32/wes/windows-event-log) channel.
+You can get a list of available event log channels by running [`Get-WinEvent -ListLog * | Format-List -Property LogName`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.diagnostics/get-winevent) in PowerShell on Windows Vista or newer.
+If `Get-WinEvent` is not available, [`Get-EventLog *`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/get-eventlog) may be used.
+Custom ingest pipelines may be added by setting one up in [Ingest Node Pipelines](/app/management/ingest/ingest_pipelines/).
 
 ## Configuration
 

packages/winlog/changelog.yml

@@ -1,4 +1,9 @@
 # newer versions go on top
+- version: "1.12.4"
+  changes:
+    - description: Improve documentation for listing event log channels.
+      type: enhancement
+      link: https://github.com/elastic/integrations/pull/5689
 - version: "1.12.3"
   changes:
     - description: Added categories and/or subcategories.

packages/winlog/docs/README.md

@@ -1,10 +1,9 @@
 # Custom Windows event log package
 
-The custom Windows event log package allows you to ingest events from
-any [Windows event log](https://docs.microsoft.com/en-us/windows/win32/wes/windows-event-log) channel.  You can get a list of available event
-log channels by running `Get-EventLog *` in PowerShell.  Custom ingest
-pipelines may be added by setting one up in
-[Ingest Node Pipelines](/app/management/ingest/ingest_pipelines/).
+The custom Windows event log package allows you to ingest events from any [Windows event log](https://docs.microsoft.com/en-us/windows/win32/wes/windows-event-log) channel.
+You can get a list of available event log channels by running [`Get-WinEvent -ListLog * | Format-List -Property LogName`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.diagnostics/get-winevent) in PowerShell on Windows Vista or newer.
+If `Get-WinEvent` is not available, [`Get-EventLog *`](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/get-eventlog) may be used.
+Custom ingest pipelines may be added by setting one up in [Ingest Node Pipelines](/app/management/ingest/ingest_pipelines/).
 
 ## Configuration
 

packages/winlog/manifest.yml

@@ -3,7 +3,7 @@ name: winlog
 title: Custom Windows Event Logs
 description: Collect and parse logs from any Windows event log channel with Elastic Agent.
 type: integration
-version: "1.12.3"
+version: "1.12.4"
 release: ga
 conditions:
   kibana.version: '^7.16.0 || ^8.0.0'