windows-itpro-docs/windows/client-management/mdm/personalization-csp.md

title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date, ms.reviewer, manager

title	description	ms.author	ms.topic	ms.prod	ms.technology	author	ms.date	ms.reviewer	manager
Personalization CSP	Use the Personalization CSP to lock screen and desktop background images, prevent users from changing the image, and use the settings in a provisioning package.	dansimp	article	w10	windows	manikadhiman	06/26/2017		dansimp

Personalization CSP

The Personalization CSP can set the lock screen and desktop background images. Setting these policies also prevents the user from changing the image. You can also use the Personalization settings in a provisioning package.

This CSP was added in Windows 10, version 1703.

Note

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.

The following shows the Personalization configuration service provider in tree format.

./Vendor/MSFT
Personalization
----DesktopImageUrl
----DesktopImageStatus
----LockScreenImageUrl
----LockScreenImageStatus

./Vendor/MSFT/Personalization

Defines the root node for the Personalization configuration service provider.

DesktopImageUrl

Specify a jpg, jpeg or png image to be used as Desktop Image. This setting can take a http or https Url to a remote image to be downloaded, a file Url to a local image.

Value type is string. Supported operations are Add, Get, Delete, and Replace.

DesktopImageStatus

Represents the status of the desktop image. Valid values:

• 1 - Successfully downloaded or copied.
• 2 - Download or copy in progress.
• 3 - Download or copy failed.
• 4 - Unknown file type.
• 5 - Unsupported URL scheme.
• 6 - Max retry failed.
• 7 - Blocked, SKU not allowed

Supporter operation is Get.

Note

This setting is only used to query status. To set the image, use the DesktopImageUrl setting.

LockScreenImageUrl

Specify a jpg, jpeg or png image to be used as Lock Screen Image. This setting can take a http or https Url to a remote image to be downloaded, a file Url to a local image.

Value type is string. Supported operations are Add, Get, Delete, and Replace.

LockScreenImageStatus

Represents the status of the lock screen image. Valid values:

• 1 - Successfully downloaded or copied.
• 2 - Download or copy in progress.
• 3 - Download or copy failed.
• 4 - Unknown file type.
• 5 - Unsupported URL scheme.
• 6 - Max retry failed.
• 7 - Blocked, SKU not allowed

Supporter operation is Get.

Note

This setting is only used to query status. To set the image, use the LockScreenImageUrl setting.

Example SyncML

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>1</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/Personalization/LockScreenImageUrl
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">chr</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data>https://www.contoso.com/desktopimage.jpeg</Data>
      </Item>
    </Replace>
    <Replace>
      <CmdID>2</CmdID>
      <Item>
        <Target>
          <LocURI>
            ./Vendor/MSFT/Personalization/DesktopImageUrl
          </LocURI>
        </Target>
        <Meta>
          <Format xmlns="syncml:metinf">chr</Format>
          <Type>text/plain</Type>
        </Meta>
        <Data>https://www.contoso.com/lockscreenimage.JPG</Data>
      </Item>
    </Replace>
    <Final/> 
  </SyncBody>
</SyncML>