mirror of
https://github.com/fleschutz/PowerShell.git
synced 2024-12-16 11:40:53 +01:00
120 lines
3.3 KiB
Markdown
120 lines
3.3 KiB
Markdown
## The *set-wallpaper.ps1* Script
|
|
|
|
This PowerShell script sets the given image file as desktop wallpaper (.JPG or .PNG supported)
|
|
|
|
## Parameters
|
|
```powershell
|
|
set-wallpaper.ps1 [[-ImageFile] <String>] [[-Style] <String>] [<CommonParameters>]
|
|
|
|
-ImageFile <String>
|
|
Specifies the path to the image file
|
|
|
|
Required? false
|
|
Position? 1
|
|
Default value
|
|
Accept pipeline input? false
|
|
Accept wildcard characters? false
|
|
|
|
-Style <String>
|
|
Specifies either Fill, Fit, Stretch, Tile, Center, or Span (default)
|
|
|
|
Required? false
|
|
Position? 2
|
|
Default value Span
|
|
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> ./set-wallpaper C:\ocean.jpg
|
|
|
|
```
|
|
|
|
## Notes
|
|
Author: Markus Fleschutz | License: CC0
|
|
|
|
## Related Links
|
|
https://github.com/fleschutz/PowerShell
|
|
|
|
## Source Code
|
|
```powershell
|
|
<#
|
|
.SYNOPSIS
|
|
Sets the given image file as desktop wallpaper
|
|
.DESCRIPTION
|
|
This PowerShell script sets the given image file as desktop wallpaper (.JPG or .PNG supported)
|
|
.PARAMETER ImageFile
|
|
Specifies the path to the image file
|
|
.PARAMETER Style
|
|
Specifies either Fill, Fit, Stretch, Tile, Center, or Span (default)
|
|
.EXAMPLE
|
|
PS> ./set-wallpaper C:\ocean.jpg
|
|
.LINK
|
|
https://github.com/fleschutz/PowerShell
|
|
.NOTES
|
|
Author: Markus Fleschutz | License: CC0
|
|
#>
|
|
|
|
param([string]$ImageFile = "", [string]$Style = "Span")
|
|
|
|
function SetWallPaper {
|
|
param([string]$Image, [ValidateSet('Fill', 'Fit', 'Stretch', 'Tile', 'Center', 'Span')][string]$Style)
|
|
|
|
$WallpaperStyle = switch($Style) {
|
|
"Fill" {"10"}
|
|
"Fit" {"6"}
|
|
"Stretch" {"2"}
|
|
"Tile" {"0"}
|
|
"Center" {"0"}
|
|
"Span" {"22"}
|
|
}
|
|
|
|
if ($Style -eq "Tile") {
|
|
New-ItemProperty -Path "HKCU:\Control Panel\Desktop" -Name WallpaperStyle -PropertyType String -Value $WallpaperStyle -Force
|
|
New-ItemProperty -Path "HKCU:\Control Panel\Desktop" -Name TileWallpaper -PropertyType String -Value 1 -Force
|
|
} else {
|
|
New-ItemProperty -Path "HKCU:\Control Panel\Desktop" -Name WallpaperStyle -PropertyType String -Value $WallpaperStyle -Force
|
|
New-ItemProperty -Path "HKCU:\Control Panel\Desktop" -Name TileWallpaper -PropertyType String -Value 0 -Force
|
|
}
|
|
Add-Type -TypeDefinition @"
|
|
using System;
|
|
using System.Runtime.InteropServices;
|
|
|
|
public class Params
|
|
{
|
|
[DllImport("User32.dll",CharSet=CharSet.Unicode)]
|
|
public static extern int SystemParametersInfo (Int32 uAction,
|
|
Int32 uParam,
|
|
String lpvParam,
|
|
Int32 fuWinIni);
|
|
}
|
|
"@
|
|
|
|
$SPI_SETDESKWALLPAPER = 0x0014
|
|
$UpdateIniFile = 0x01
|
|
$SendChangeEvent = 0x02
|
|
|
|
$fWinIni = $UpdateIniFile -bor $SendChangeEvent
|
|
|
|
$ret = [Params]::SystemParametersInfo($SPI_SETDESKWALLPAPER, 0, $Image, $fWinIni)
|
|
}
|
|
|
|
try {
|
|
if ($ImageFile -eq "" ) { $ImageFile = read-host "Enter path to image file" }
|
|
|
|
SetWallPaper -Image $ImageFile -Style $Style
|
|
"✔️ Done."
|
|
exit 0 # success
|
|
} catch {
|
|
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
|
|
exit 1
|
|
}
|
|
```
|
|
|
|
*Generated by convert-ps2md.ps1 using the comment-based help of set-wallpaper.ps1*
|