mirror of
https://github.com/fleschutz/PowerShell.git
synced 2024-12-16 19:50:45 +01:00
85 lines
2.6 KiB
Markdown
85 lines
2.6 KiB
Markdown
## The *save-screenshot.ps1* Script
|
||
|
||
This PowerShell script takes a single screenshot and saves it into a target folder (the user's pictures folder by default).
|
||
|
||
## Parameters
|
||
```powershell
|
||
save-screenshot.ps1 [[-TargetFolder] <String>] [<CommonParameters>]
|
||
|
||
-TargetFolder <String>
|
||
Specifies the target folder (the user's pictures folder by default)
|
||
|
||
Required? false
|
||
Position? 1
|
||
Default value "$HOME/Pictures"
|
||
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> ./save-screenshot
|
||
✔️ screenshot saved to C:\Users\Markus\Pictures\2021-10-10T14-33-22.png
|
||
|
||
```
|
||
|
||
## Notes
|
||
Author: Markus Fleschutz | License: CC0
|
||
|
||
## Related Links
|
||
https://github.com/fleschutz/PowerShell
|
||
|
||
## Source Code
|
||
```powershell
|
||
<#
|
||
.SYNOPSIS
|
||
Saves a single screenshot
|
||
.DESCRIPTION
|
||
This PowerShell script takes a single screenshot and saves it into a target folder (the user's pictures folder by default).
|
||
.PARAMETER TargetFolder
|
||
Specifies the target folder (the user's pictures folder by default)
|
||
.EXAMPLE
|
||
PS> ./save-screenshot
|
||
✔️ screenshot saved to C:\Users\Markus\Pictures\2021-10-10T14-33-22.png
|
||
.LINK
|
||
https://github.com/fleschutz/PowerShell
|
||
.NOTES
|
||
Author: Markus Fleschutz | License: CC0
|
||
#>
|
||
|
||
param([string]$TargetFolder = "$HOME/Pictures")
|
||
|
||
function TakeScreenshot { param([string]$FilePath)
|
||
Add-Type -Assembly System.Windows.Forms
|
||
$ScreenBounds = [Windows.Forms.SystemInformation]::VirtualScreen
|
||
$ScreenshotObject = New-Object Drawing.Bitmap $ScreenBounds.Width, $ScreenBounds.Height
|
||
$DrawingGraphics = [Drawing.Graphics]::FromImage($ScreenshotObject)
|
||
$DrawingGraphics.CopyFromScreen( $ScreenBounds.Location, [Drawing.Point]::Empty, $ScreenBounds.Size)
|
||
$DrawingGraphics.Dispose()
|
||
$ScreenshotObject.Save($FilePath)
|
||
$ScreenshotObject.Dispose()
|
||
}
|
||
|
||
try {
|
||
if (-not(test-path "$TargetFolder" -pathType container)) {
|
||
throw "Target folder at 📂$TargetFolder doesn't exist"
|
||
}
|
||
$Time = (Get-Date)
|
||
$Filename = "$($Time.Year)-$($Time.Month)-$($Time.Day)T$($Time.Hour)-$($Time.Minute)-$($Time.Second).png"
|
||
$FilePath = (Join-Path $TargetFolder $Filename)
|
||
TakeScreenshot $FilePath
|
||
|
||
"✔️ screenshot saved to $FilePath"
|
||
exit 0 # success
|
||
} catch {
|
||
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
|
||
exit 1
|
||
}
|
||
```
|
||
|
||
*Generated by convert-ps2md.ps1 using the comment-based help of save-screenshot.ps1*
|