windows-itpro-docs/windows/client-management/mdm/policy-csp-devicelock.md
2021-08-27 15:09:49 -07:00

32 KiB
Raw Blame History

title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.localizationpriority, ms.date, ms.reviewer, manager
title description ms.author ms.topic ms.prod ms.technology author ms.localizationpriority ms.date ms.reviewer manager
Policy CSP - DeviceLock Learn how to use the Policy CSP - DeviceLock setting to specify whether the user must input a PIN or password when the device resumes from an idle state. dansimp article w10 windows manikadhiman medium 09/27/2019 dansimp

Policy CSP - DeviceLock


DeviceLock policies

DeviceLock/AllowIdleReturnWithoutPassword
DeviceLock/AllowSimpleDevicePassword
DeviceLock/AlphanumericDevicePasswordRequired
DeviceLock/DevicePasswordEnabled
DeviceLock/DevicePasswordExpiration
DeviceLock/DevicePasswordHistory
DeviceLock/EnforceLockScreenAndLogonImage
DeviceLock/MaxDevicePasswordFailedAttempts
DeviceLock/MaxInactivityTimeDeviceLock
DeviceLock/MinDevicePasswordComplexCharacters
DeviceLock/MinDevicePasswordLength
DeviceLock/MinimumPasswordAge
DeviceLock/PreventEnablingLockScreenCamera
DeviceLock/PreventLockScreenSlideShow

DeviceLock/AllowIdleReturnWithoutPassword

Windows Edition Supported?
Home cross mark
Pro cross mark
Business cross mark
Enterprise cross mark
Education cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

Currently, this policy is supported only in HoloLens 2, HoloLens (1st gen) Commercial Suite, and HoloLens (1st gen) Development Edition.

Specifies whether the user must input a PIN or password when the device resumes from an idle state.

Note

This policy must be wrapped in an Atomic command.

The following list shows the supported values:

  • 0 Not allowed.
  • 1 (default) Allowed.

DeviceLock/AllowSimpleDevicePassword

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies whether PINs or passwords such as "1111" or "1234" are allowed. For the desktop, it also controls the use of picture passwords.

Note

 This policy must be wrapped in an Atomic command.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview.

The following list shows the supported values:

  • 0 Not allowed.
  • 1 (default) Allowed.

DeviceLock/AlphanumericDevicePasswordRequired

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Determines the type of PIN required. This policy only applies if the DeviceLock/DevicePasswordEnabled policy is set to 0 (required).

Note

 This policy must be wrapped in an Atomic command.

Always use the Replace command instead of Add for this policy in Windows 10 for desktop editions (Home, Pro, Enterprise, and Education).

Note

 If AlphanumericDevicePasswordRequired is set to 1 or 2, then MinDevicePasswordLength = 0 and MinDevicePasswordComplexCharacters = 1.

If AlphanumericDevicePasswordRequired is set to 0, then MinDevicePasswordLength = 4 and MinDevicePasswordComplexCharacters = 2.

The following list shows the supported values:

  • 0 Password or Alphanumeric PIN required.
  • 1 Password or Numeric PIN required.
  • 2 (default) Password, Numeric PIN, or Alphanumeric PIN required.

DeviceLock/DevicePasswordEnabled

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies whether device lock is enabled.

Note

 This policy must be wrapped in an Atomic command.

Always use the Replace command instead of Add for this policy in Windows 10 for desktop editions.

Important

The DevicePasswordEnabled setting must be set to 0 (device password is enabled) for the following policy settings to take effect:

  • AllowSimpleDevicePassword
  • MinDevicePasswordLength
  • AlphanumericDevicePasswordRequired
  • MaxDevicePasswordFailedAttempts
  • MaxInactivityTimeDeviceLock
  • MinDevicePasswordComplexCharacters  

Important

If DevicePasswordEnabled is set to 0 (device password is enabled), then the following policies are set:

  • MinDevicePasswordLength is set to 4
  • MinDevicePasswordComplexCharacters is set to 1

If DevicePasswordEnabled is set to 1 (device password is disabled), then the following DeviceLock policies are set to 0:

  • MinDevicePasswordLength
  • MinDevicePasswordComplexCharacters

Important

DevicePasswordEnabled should not be set to Enabled (0) when WMI is used to set the EAS DeviceLock policies given that it is Enabled by default in Policy CSP for back compat with Windows 8.x. If DevicePasswordEnabled is set to Enabled(0) then Policy CSP will return an error stating that DevicePasswordEnabled already exists. Windows 8.x did not support DevicePassword policy. When disabling DevicePasswordEnabled (1) then this should be the only policy set from the DeviceLock group of policies listed below:

  • DevicePasswordEnabled is the parent policy of the following:
    • AllowSimpleDevicePassword
    • MinDevicePasswordLength
    • AlphanumericDevicePasswordRequired
    • MinDevicePasswordComplexCharacters 
    • DevicePasswordExpiration
    • DevicePasswordHistory
    • MaxDevicePasswordFailedAttempts
    • MaxInactivityTimeDeviceLock

The following list shows the supported values:

  • 0 (default) Enabled
  • 1 Disabled

DeviceLock/DevicePasswordExpiration

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies when the password expires (in days).

Note

 This policy must be wrapped in an Atomic command.

If all policy values = 0 then 0; otherwise, Min policy value is the most secure value.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview.

The following list shows the supported values:

  • An integer X where 0 <= X <= 730.
  • 0 (default) - Passwords do not expire.

DeviceLock/DevicePasswordHistory

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies how many passwords can be stored in the history that cant be used.

Note

 This policy must be wrapped in an Atomic command.

The value includes the user's current password. This means that with a setting of 1 the user cannot reuse their current password when choosing a new password, while a setting of 5 means that a user cannot set their new password to their current password or any of their previous four passwords.

Max policy value is the most restricted.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview.

The following list shows the supported values:

  • An integer X where 0 <= X <= 50.
  • 0 (default)

DeviceLock/EnforceLockScreenAndLogonImage

Windows Edition Supported?
Home check mark1
Pro check mark1
Business check mark1
Enterprise check mark1
Education check mark1

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1607. Specifies the default lock screen and logon image shown when no user is signed in. It also sets the specified image for all users, which replaces the default image. The same image is used for both the lock and logon screens. Users will not be able to change this image.

Note

 This policy is only enforced in Windows 10 Enterprise and Education editions and not supported in Windows 10 Home and Pro.

Value type is a string, which is the full image filepath and filename.


DeviceLock/MaxDevicePasswordFailedAttempts

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

The number of authentication failures allowed before the device will be wiped. A value of 0 disables device wipe functionality.

Note

 This policy must be wrapped in an Atomic command.

This policy has different behaviors on the mobile device and desktop.

  • On a mobile device, when the user reaches the value set by this policy, then the device is wiped.

  • On a desktop, when the user reaches the value set by this policy, it is not wiped. Instead, the desktop is put on BitLocker recovery mode, which makes the data inaccessible but recoverable. If BitLocker is not enabled, then the policy cannot be enforced.

    Prior to reaching the failed attempts limit, the user is sent to the lock screen and warned that more failed attempts will lock their computer. When the user reaches the limit, the device automatically reboots and shows the BitLocker recovery page. This page prompts the user for the BitLocker recovery key.

Most secure value is 0 if all policy values = 0; otherwise, Min policy value is the most secure value.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview.

The following list shows the supported values:

  • An integer X where 4 <= X <= 16 for desktop and 0 <= X <= 999 for mobile devices.
  • 0 (default) - The device is never wiped after an incorrect PIN or password is entered.

DeviceLock/MaxInactivityTimeDeviceLock

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies the maximum amount of time (in minutes) allowed after the device is idle that will cause the device to become PIN or password locked. Users can select any existing timeout value less than the specified maximum time in the Settings app.

  • On Mobile, the Lumia 950 and 950XL have a maximum timeout value of 5 minutes, regardless of the value set by this policy.
  • On HoloLens, this timeout is controlled by the device's system sleep timeout, regardless of the value set by this policy.

Note

 This policy must be wrapped in an Atomic command.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview.

The following list shows the supported values:

  • An integer X where 0 <= X <= 999.
  • 0 (default) - No timeout is defined. The default of "0" is Windows Phone 7.5 parity and is interpreted by as "No timeout is defined."

DeviceLock/MinDevicePasswordComplexCharacters

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

The number of complex element types (uppercase and lowercase letters, numbers, and punctuation) required for a strong PIN or password.

Note

 This policy must be wrapped in an Atomic command.

Always use the Replace command instead of Add for this policy in Windows 10 for desktop editions.

PIN enforces the following behavior for desktop and mobile devices:

  • 1 - Digits only
  • 2 - Digits and lowercase letters are required
  • 3 - Digits, lowercase letters, and uppercase letters are required. Not supported in desktop Microsoft accounts and domain accounts.
  • 4 - Digits, lowercase letters, uppercase letters, and special characters are required. Not supported in desktop or HoloLens.

The default value is 1. The following list shows the supported values and actual enforced values:

Account Type Supported Values Actual Enforced Values

Mobile

1,2,3,4

Same as the value set

Desktop Local Accounts

1,2,3

3

Desktop Microsoft Accounts

1,2

<p2

Desktop Domain Accounts

Not supported

Not supported

Enforced values for Local and Microsoft Accounts:

  • Local accounts support values of 1, 2, and 3, however they always enforce a value of 3.

  • Passwords for local accounts must meet the following minimum requirements:

    • Not contain the user's account name or parts of the user's full name that exceed two consecutive characters

    • Be at least six characters in length

    • Contain characters from three of the following four categories:

      • English uppercase characters (A through Z)
      • English lowercase characters (a through z)
      • Base 10 digits (0 through 9)
      • Special characters (!, $, #, %, etc.)

The enforcement of policies for Microsoft accounts happen on the server, and the server requires a password length of 8 and a complexity of 2. A complexity value of 3 or 4 is unsupported and setting this value on the server makes Microsoft accounts non-compliant.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview and KB article.


DeviceLock/MinDevicePasswordLength

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Specifies the minimum number or characters required in the PIN or password.

Note

 This policy must be wrapped in an Atomic command.

Always use the Replace command instead of Add for this policy in Windows 10 for desktop editions.

Max policy value is the most restricted.

For additional information about this policy, see Exchange ActiveSync Policy Engine Overview and KB article.

The following list shows the supported values:

  • An integer X where 4 <= X <= 16 for mobile devices and desktop. However, local accounts will always enforce a minimum password length of 6.
  • Not enforced.
  • The default value is 4 for mobile devices and desktop devices.

The following example shows how to set the minimum password length to 4 characters.

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Replace>
            <CmdID>$CmdID$</CmdID>
            <Item>
                <Target>
                    <LocURI>./Vendor/MSFT/Policy/Config/DeviceLock/MinDevicePasswordLength</LocURI>
                </Target>
                <Meta>
                    <Format xmlns="syncml:metinf">int</Format>
                </Meta>
                <Data>4</Data>
            </Item>
        </Replace>
        <Final/>
    </SyncBody>
</SyncML>

DeviceLock/MinimumPasswordAge

Windows Edition Supported?
Home check mark3
Pro check mark3
Business check mark3
Enterprise check mark3
Education check mark3

Scope:

[!div class = "checklist"]

  • Device

This security setting determines the period of time (in days) that a password must be used before the user can change it. You can set a value between 1 and 998 days, or you can allow changes immediately by setting the number of days to 0.

The minimum password age must be less than the Maximum password age, unless the maximum password age is set to 0, indicating that passwords will never expire. If the maximum password age is set to 0, the minimum password age can be set to any value between 0 and 998.

Configure the minimum password age to be more than 0 if you want Enforce password history to be effective. Without a minimum password age, users can cycle through passwords repeatedly until they get to an old favorite. The default setting does not follow this recommendation, so that an administrator can specify a password for a user and then require the user to change the administrator-defined password when the user logs on. If the password history is set to 0, the user does not have to choose a new password. For this reason, Enforce password history is set to 1 by default.

GP Info:

  • GP Friendly name: Minimum password age
  • GP path: Windows Settings/Security Settings/Account Policies/Password Policy

DeviceLock/PreventEnablingLockScreenCamera

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Disables the lock screen camera toggle switch in PC Settings and prevents a camera from being invoked on the lock screen.

By default, users can enable invocation of an available camera on the lock screen.

If you enable this setting, users will no longer be able to enable or disable lock screen camera access in PC Settings, and the camera cannot be invoked on the lock screen.

Tip

This is an ADMX-backed policy and requires a special SyncML format to enable or disable. For details, see Understanding ADMX-backed policies.

You must specify the data type in the SyncML as <Format>chr</Format>. For an example SyncML, refer to Enabling a policy.

The payload of the SyncML must be XML-encoded; for this XML encoding, there are a variety of online encoders that you can use. To avoid encoding the payload, you can use CDATA if your MDM supports it. For more information, see CDATA Sections.

ADMX Info:

  • GP Friendly name: Prevent enabling lock screen camera
  • GP name: CPL_Personalization_NoLockScreenCamera
  • GP path: Control Panel/Personalization
  • GP ADMX file name: ControlPanelDisplay.admx

DeviceLock/PreventLockScreenSlideShow

Windows Edition Supported?
Home check mark
Pro check mark
Business check mark
Enterprise check mark
Education check mark

Scope:

[!div class = "checklist"]

  • Device

Disables the lock screen slide show settings in PC Settings and prevents a slide show from playing on the lock screen.

By default, users can enable a slide show that will run after they lock the machine.

If you enable this setting, users will no longer be able to modify slide show settings in PC Settings, and no slide show will ever start.

Tip

This is an ADMX-backed policy and requires a special SyncML format to enable or disable. For details, see Understanding ADMX-backed policies.

You must specify the data type in the SyncML as <Format>chr</Format>. For an example SyncML, refer to Enabling a policy.

The payload of the SyncML must be XML-encoded; for this XML encoding, there are a variety of online encoders that you can use. To avoid encoding the payload, you can use CDATA if your MDM supports it. For more information, see CDATA Sections.

ADMX Info:

  • GP Friendly name: Prevent enabling lock screen slide show
  • GP name: CPL_Personalization_NoLockScreenSlideshow
  • GP path: Control Panel/Personalization
  • GP ADMX file name: ControlPanelDisplay.admx

Footnotes:

  • 1 - Available in Windows 10, version 1607.
  • 2 - Available in Windows 10, version 1703.
  • 3 - Available in Windows 10, version 1709.
  • 4 - Available in Windows 10, version 1803.
  • 5 - Available in Windows 10, version 1809.
  • 6 - Available in Windows 10, version 1903.
  • 7 - Available in Windows 10, version 1909.
  • 8 - Available in Windows 10, version 2004.