PowerShell/docs/check-vpn.md

69 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2024-11-08 12:38:20 +01:00
The *check-vpn.ps1* Script
===========================
2021-12-09 16:19:09 +01:00
2023-09-01 17:53:03 +02:00
This PowerShell script queries the status of the VPN connection(s) and prints it.
2021-12-09 16:19:09 +01:00
2023-07-29 10:04:38 +02:00
Parameters
----------
2021-12-09 16:19:09 +01:00
```powershell
2024-11-08 12:35:11 +01:00
/home/markus/Repos/PowerShell/scripts/check-vpn.ps1 [<CommonParameters>]
2021-12-09 16:19:09 +01:00
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
2023-07-29 10:04:38 +02:00
Example
-------
2021-12-09 16:19:09 +01:00
```powershell
2023-07-29 09:45:37 +02:00
PS> ./check-vpn.ps1
2023-09-13 09:49:05 +02:00
✅ VPN to NASA L2TP is connected
2021-12-09 16:19:09 +01:00
```
2023-07-29 10:04:38 +02:00
Notes
-----
2022-11-17 19:46:02 +01:00
Author: Markus Fleschutz | License: CC0
2021-12-09 16:19:09 +01:00
2023-07-29 10:04:38 +02:00
Related Links
-------------
2021-12-09 16:19:09 +01:00
https://github.com/fleschutz/PowerShell
2023-07-29 10:04:38 +02:00
Script Content
--------------
2022-11-17 20:05:34 +01:00
```powershell
2022-11-17 20:02:26 +01:00
<#
.SYNOPSIS
2023-05-26 12:20:18 +02:00
Checks the VPN status
2022-11-17 20:02:26 +01:00
.DESCRIPTION
2023-09-01 17:53:03 +02:00
This PowerShell script queries the status of the VPN connection(s) and prints it.
2022-11-17 20:02:26 +01:00
.EXAMPLE
2023-07-29 09:45:37 +02:00
PS> ./check-vpn.ps1
2023-09-13 09:49:05 +02:00
✅ VPN to NASA L2TP is connected
2022-11-17 20:02:26 +01:00
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
try {
2023-09-01 17:53:03 +02:00
$noVPN = $true
2022-11-17 20:02:26 +01:00
if ($IsLinux) {
# TODO
} else {
2024-05-19 10:25:56 +02:00
$connections = Get-VPNConnection
foreach($connection in $connections) {
Write-Host "✅ VPN to $($connection.Name) is $($connection.ConnectionStatus.ToLower())"
2023-09-01 17:53:03 +02:00
$noVPN = $false
2022-11-17 20:02:26 +01:00
}
}
2023-09-01 17:53:03 +02:00
if ($noVPN) { Write-Host "⚠️ No VPN configured" }
2022-11-17 20:02:26 +01:00
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
2022-11-17 20:05:34 +01:00
```
2022-11-17 20:02:26 +01:00
2024-11-20 11:52:20 +01:00
*(generated by convert-ps2md.ps1 as of 11/20/2024 11:51:52)*