PowerShell/Docs/list-news.md

81 lines
2.2 KiB
Markdown
Raw Normal View History

2022-11-17 20:02:26 +01:00
## The list-news.ps1 PowerShell Script
2021-11-08 21:36:42 +01:00
2022-11-17 19:46:02 +01:00
This PowerShell script lists the latest news by using RSS (Really Simple Syndication) feeds.
2021-11-08 21:36:42 +01:00
## Parameters
```powershell
2021-12-09 16:19:09 +01:00
list-news.ps1 [[-RSS_URL] <String>] [[-MaxCount] <Int32>] [<CommonParameters>]
2021-11-08 21:36:42 +01:00
-RSS_URL <String>
2022-11-17 19:46:02 +01:00
Specifies the URL to the RSS feed (Yahoo News by default)
2021-11-08 21:36:42 +01:00
Required? false
Position? 1
Default value https://yahoo.com/news/rss/world
Accept pipeline input? false
Accept wildcard characters? false
-MaxCount <Int32>
2022-11-17 19:46:02 +01:00
Specifies the number of lines to list (20 by default)
2021-11-08 21:36:42 +01:00
Required? false
Position? 2
Default value 20
Accept pipeline input? false
Accept wildcard characters? false
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
## Example
```powershell
PS> ./list-news
```
## Notes
2022-11-17 19:46:02 +01:00
Author: Markus Fleschutz | License: CC0
2021-11-08 21:36:42 +01:00
## Related Links
https://github.com/fleschutz/PowerShell
2022-11-17 20:02:26 +01:00
## Source Code
<#
.SYNOPSIS
Lists the news
.DESCRIPTION
This PowerShell script lists the latest news by using RSS (Really Simple Syndication) feeds.
.PARAMETER RSS_URL
Specifies the URL to the RSS feed (Yahoo News by default)
.PARAMETER MaxCount
Specifies the number of lines to list (20 by default)
.EXAMPLE
PS> ./list-news
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
param([string]$RSS_URL = "https://yahoo.com/news/rss/world", [int]$MaxCount = 20)
try {
[xml]$Content = (Invoke-WebRequest -URI $RSS_URL -useBasicParsing).Content
[int]$Count = 1
foreach ($Item in $Content.rss.channel.item) {
& "$PSScriptRoot/write-typewriter.ps1" "→ $($Item.title)" 20 # ms speed
if ($Count++ -eq $MaxCount) { break }
}
$Source = $Content.rss.channel.title
$Date = $Content.rss.channel.pubDate
" By *$($Source)* as of $Date"
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
2021-11-08 21:36:42 +01:00
*Generated by convert-ps2md.ps1 using the comment-based help of list-news.ps1*