92 lines
2.3 KiB
Markdown
92 lines
2.3 KiB
Markdown
## Description
|
|
|
|
This function will set the targets wallpaper to the provided image
|
|
|
|
## The Function
|
|
|
|
### [Set-WallPaper]
|
|
|
|
Using the following syntax will set the targets desktop wallpaper to an image of your choosing:
|
|
|
|
```PowerShell
|
|
Set-WallPaper -Image "$Env:USERPROFILE\Desktop\$ImageName.jpg" -Style Center
|
|
```
|
|
|
|
```PowerShell
|
|
Function Set-WallPaper {
|
|
|
|
<#
|
|
|
|
.SYNOPSIS
|
|
Applies a specified wallpaper to the current user's desktop
|
|
|
|
.PARAMETER Image
|
|
Provide the exact path to the image
|
|
|
|
.PARAMETER Style
|
|
Provide wallpaper style (Example: Fill, Fit, Stretch, Tile, Center, or Span)
|
|
|
|
.EXAMPLE
|
|
Set-WallPaper -Image "C:\Wallpaper\Default.jpg"
|
|
Set-WallPaper -Image "C:\Wallpaper\Background.jpg" -Style Fit
|
|
|
|
#>
|
|
|
|
|
|
param (
|
|
[parameter(Mandatory=$True)]
|
|
# Provide path to image
|
|
[string]$Image,
|
|
# Provide wallpaper style that you would like applied
|
|
[parameter(Mandatory=$False)]
|
|
[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)
|
|
}
|
|
``` |