This blog post uses the Personalization configuration service provider (CSP) to manage the desktop and lock screen image on Windows 10 devices. This CSP was added in Windows 10, version 1703, which is currently available as Insider Preview build.
This blog post is about the ability to easily configure separate images for the desktop and the lock screen on Windows 10 devices. Before Windows 10, version 1703, this was possible by using an MSI or by using the EnforceLockScreenAndLogonImage setting. However, the latter setting was only able to configure the lock screen image and not the desktop image. Windows 10, version 1703, introduces the Personalization CSP, which enables the administrator to manage the desktop and lock screen image. In this post I’ll briefly go through the available settings in the Personalization CSP and I’ll show how to configure the desktop and lock screen image via Microsoft Intune hybrid and Microsoft Intune standalone. I’ll end this post by showing the end-user experience.
Configuration
Now let’s start with the configuration. Like last week I’ll split the configuration in two sections. The first section is about the available settings in the Personalization CSP and the second section is about the configuration of the desktop and lock screen image.
Available settings
As the Personalization CSP is new in Windows 10, version 1703, I thought it would be good to briefly go through the available settings. The root node for the Personalization CSP is ./Vendor/MSFT/Personalization and it contains the following settings.
Setting | Description |
DesktopImageUrl | This setting allows the administrator to specify an image to be used as desktop image. |
DesktopImageStatus | This setting allows the administrator to query the status of the desktop image. |
LockScreenImageUrl | This setting allows the administrator to specify an image to be used as lock screen image. |
LockScreenImageStatus | This setting allows the administrator to query the status of the lock screen image. |
Configure settings
After going through the available settings in the Personalization CSP, it’s good to know that only the DesktopImageUrl and the LockScreenImageUrl are configurable settings. The other two settings can only be used to query the status. To configure the desktop and lock screen image, the following OMA-URI configurations can be used (in both cases the data type and value are the same):
- OMA-URI – Desktop image: ./Vendor/MSFT/Personalization/DesktopImageUrl
- OMA-URI – Lock screen image: ./Vendor/MSFT/Personalization/LockScreenImageUrl
- Data type: String
- Value: [<PATH>\<FILE>]
- In this value <PATH> can be a http(s) url, or a file url;
- In this value <FILE> can be a jpg, jpeg or png image.
This configuration information can be used in Microsoft Intune hybrid and Microsoft Intune standalone, by using the configuration guidelines shown below.
End-user experience
As usual, let’s end this post with the end-user experience. Before really going to the end-user experience, it’s good to show an easy method to verify the configuration. The configuration can be verified In the registry, at HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\PersonalizationCSP. At this location it shows the url and the status of the desktop and lock screen image. Even better, it also show the local path of both images. In other words, whether the image is local, or remote, it will always be cached and used from a local location, as shown below.
The real end-user experience is, of course, not in the registry. The real en-user experience can be easily found when logging on to the configured Windows 10 device. The desktop image will be configured, as shown below on the right, and the lock screen image will be configured, as shown below on the left.
More information
For more information about the Personalization CSP, please refer to this article about the Personalization CSP.
Nice article. I would like those images too 🙂
Thank you, Matt!
FYI: The Personalization CSP is only available on Windows 10 Enterprise and Education SKU, see More information section in this article.
That’s correct!
Why is this a HKLM red key? Can we not specify the background image per user?
To my knowledge not at this moment. Once configured, the setting will be greyed out for the end-user.
One thing I found was that if the Personalisation button under settings was turned off the policy would not apply on a Windows 10 device.
Hope this helps people
Thank you, Jon!
Hi, is it possible to enforce password on lockscreen on windows 10 (Desktop) ?
Thank for your guidance.
Hi Edouard,
Not sure what you’re exactly looking for, something like this? If not, please provide some more details.
Regards, Peter
Hi Peter,
Can you confirm if the url can be within a sharepoint environment? It doesn’t seem to work for me but Ive successfully rolled out an image published on the internet.
If not, how can I deploy an image to all user devices to then link to.
Thanks,
Kevin
Hi Kevin,
I haven’t specifically tested with a SharePoint environment, so I can’t confirm the behavior. Theoretically speaking, it should be an URL to which the user has access, which doesn’t directly exclude SharePoint.
Regards, Peter
This is perfect, thanks so much!
Any idea if/how often it polls for a new image? I couldn’t get it to update without renaming the image and changing the configuration policy.
Hi Matt,
I’m sorry, I’m not aware of any polling interval, or that it simply does a name check.
Regards, Peter
Note: Keep in mind that this configuration is also available nowadays in the device configuration policies.
Thanks for this article. This might be overkill, but its a way to force the wallpaper to be re-downloaded, such as in the case where its updated server-side on a regular basis:
https://github.com/MicrosoftDocs/windows-itpro-docs/issues/10329
Thank you for sharing Mike.
Regards, Peter
Hi Peter,
Nice article, but you might want to consider placing the “only available on Windows 10 Enterprise” FYI somewhere on top in the article. I am new to Intune and just spent a couple of hours trying to change the desktop of my Windows 10 Pro clients with this method….. 🙂
Or are there other clues that should have rang any bells?
Regards,
Hi Glenn,
Yeah, I know. However, I didn’t do that due to the note on top of the page of the Personalization CSP: “Personalization CSP is supported in Windows 10 Enterprise and Education SKUs. It works in Windows 10 Pro and Windows 10 Pro in S mode if SetEduPolicies in SharedPC CSP is set.” So, basically there is a method to make it work in Windows 10 Pro.
Regards, Peter
Hi Peter, Is there a way to set the background but also allow users to change afterwards?
Hi Damo,
Yes, but to my knowledge not by using the CSP at this moment. You could create a custom MSI.
Regards, Peter
Has anyone found a way to disable Windows Spotlight via CSP also ?
The feature that that gives tips and facts on the lockscreen.
Hi Jason,
Have a look at the experience settings in the Policy CSP (https://docs.microsoft.com/en-us/windows/client-management/mdm/policy-configuration-service-provider).
Regards, Peter
hi there
i used a script to download an image I created.
“$url = “https://XXX.com/XXXYYY”
$output = “c:\background.jpg”
Start-BitsTransfer -Source $url -Destination $output”
So my image is downloaded in c:\background.jpg.
But then, i used these CSP…and….not working !
In the registry, DesktopImageStatus and LockScreenImageStatus are at “2”
2 mean “download or copy in progress” (https://docs.microsoft.com/en-us/windows/client-management/mdm/personalization-csp)
But my image is downloaded….!
I don’t understand….
Hi Dan,
You can simply specify the web location and it will download it locally itself. Also, nowadays you can also use a configuration policy to configure this setting via the UI.
Regards, Peter
where is this config policy ? it only works with “enterprise sku” right ?
that’s why i’m using this csp…:-)
the problem is : i created a personal image. So i need to upload this image somewhere. It doesn’t seem to work with sharepoint. and i don’t want to upload this image on some website….
Hi Dan,
The policy is available via Device restrictions > Locked Screen experience.
Regards, Peter
where ? you have to be more specific than that.
i’m a noob !
Please, detail the exact path 🙂
Hi Dan,
It’s a device restriction policy setting.
Regards, Peter
I tested on, 1809 machine. The image URL is dilivered to the registry location but is not taking effect on the device, both Lockscreen and desktop wallpaper
Hi Ankit,
Did you also look at the available device configuration policy settings?
Regards, Peter
Hi Peter,
Is it ok to use edu policies in w10 pro in regards to licens? Dont you need to be eligible for Education or enterprise licenses?
Hi Johan,
Depending on the Windows 10 edition, some configuration options are not available.
Regards, Peter
Thank you!
I have a w10 pro controlled by intune and wanted lockscreen enabled, which seemed to work when I enabled setEduPolicies but Im uncertain about being compliant with ms licensing since I dont have enterprize or edu sku?
Hi Johan,
I’m not a licensing expert, but to my knowledge you are allowed to configure whatever you can configure. Sometimes that just means that the easy road is not possible.
Regards, Peter
So my device is Wind 10 1809 Pro, I used the Set EDU policy
then deployed desktop background and Lockscreen.
In the registory, I see that the Dword value 6, istead of 1 and no Desktop image Path / lock screen path
Hi Ankit,
6 means Max retry failed.
Regards, Peter
Is there capability to set an image based on aspect ratio? I need to cater for 16:9 and 16:10
Not via this CSP configuration, Paul.
Hello Peter,
Do you know how long the Lockscreen image is saved locally? Is it downloaded every time at startup?
Hi Michael,
I haven’t tested that, but I would think that it’s downloaded when the policy is applied.
Regards, Peter
Peter – many thanks for this, the Experience CSP thing is where I’m stopped now. I can use the PersonalizationCSP things to create reg keys from GPO that let me specify lock screen image, but still getting Windows Spotlight info overlays. I see there’s an Experience CSP that can turn that off but I’m a little lost getting from that info to a reg key for non-intune devices.
Hi Andrew,
The Windows Spotlight settings are available in a device restriction policy.
Regards, Peter
Hi Peter – yes, that’s true – I mistyped – You can turn off the Spotlight stuff under the Policy CSP in an Experience section, but just as the Personalization CSP maps to reg keys and can be set with GPOs, I figure that the PolicyCSP can be as well. But I’m not skilled enough to figure out the reg key to deal with the Spotlight issues. I can set the regkeys you identify in the above image with a GPO, and I got the picure I set as the lockscreen background, but Spotlight was locked in settings as the default lockscreen, and the spotlight “Like what you see?” overlays kept appearing over the picture I set. I think there’s a clue in the Policy CSP Experience ConfigWindowsSpotlightOnLockscreen setting, but I don’t know how to figure out what the reg key to set with GPO is from the CSP info. You’ve halfway let the cat out of the bag here, maybe let’s let him all the way out?
Hi Andrew,
The documentation about that setting provide you with the requested information. In this case that setting is an ADMX-backed policy setting, which means that it can be found in the mentioned ADMX-file.
Regards, Peter
Does the user on the device have to be a local admin?
The setup only works for 1 device (which is global admin in azure) all other devices gives this error: Syncml(406): The requested command failed because an optional feature in the request was not supported.
Any ideas what that could be about?
Hi Claus,
Which edition of Windows 10 are using?
Regards, Peter
Hi Peter, thank you for quick reply. I use Windows 10 Pro version 1909. I have Enabled SharedPC Mode on the devices. Just strange that it works for the global admin but not for anyone else.
Hi Claus,
I haven’t looked at that combination yet. Do you see the same behavior with the Enterprise edition?
Regards, Peter
Hi Peter, Thank you for this wonderful article, I am looking for enterprisedesktopappmanagement-csp, can you help me with it, from Microsoft doc it’s not very clear about what values has to be passed for every OMA-URI configurations. one example would help me .
Hi Vandana,
What is it that you’re trying to achieve by using that CSP?
Regards, Peter
Great article Peter and thanks for sharing but like others i’ve hit issues with the joy of working with Windows 10 Professional rather than Windows 10 Enterprise. I repeatedly find issues around these custom controls not working on professional edition. Really important imho that you flag this at the start of your articles.
I don’t want to be enabling education mode on my build as it would be potentially too restrictive.
Thank you for your feedback, Jim.
Hi Peter, thanks for this! Although doesn’t seem to work for me I think I must be doing something wrong but cant figure out what! The only difference I can see is that where your Desktopimagestatus and Lockscreenimagestatus is set to 1 mine is set to 3? What does this mean and how do I rectify this? Please help!
Hi Aran,
That means that the download or the copy of your image failed.
Regards, Peter
Hello Peter,
I have set the wallpaper for the user machine but at the same time, I want to allow users to change the wallpaper as per their preference. Any suggestions
Testing this scenario but so far no success.
Hi Raghav,
This method locks the wallpaper for users. If you want users to be able to change, you might want to look at a scripted solution.
Regards, Peter
Is there an update for this?
The option is still there in device configuration, but ATM I can not use it (we are 100% cloud based with no storage)
it does not appear to accept a SharePoint url – no surprise.
also.
the reg entry listed above no longer seems to be used – I cant find it even when searching for PersonalizationCSP
Hi Doug,
You can also use Azure blob storage as the location.
Regards, Peter
Hi Peter,
We use Azure blob storage as the picture location. And I can find the picture URL in the regediter in computer.
But the picture doesn’t display. What can I to check?
Hi Jason,
You can verify the registry location (as shown in the experience section) for the status message.
Regards, Peter
Hi,
I am using windows 10 business and I am unable to find personalization CSP on that after making all the changes. Is there any other way to implement this.
Hi Hassan,
The Personalization CSP is supported in Windows 10 Enterprise and Education SKUs.
Regards, Peter