windows-itpro-docs/windows/client-management/mdm/policy-csp-security.md

---
title: Security Policy CSP
description: Learn more about the Security Area in Policy CSP.
ms.date: 01/18/2024
---

<!-- Auto-Generated CSP Document -->

<!-- Security-Begin -->
# Policy CSP - Security

<!-- Security-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- Security-Editable-End -->

<!-- AllowAddProvisioningPackage-Begin -->
## AllowAddProvisioningPackage

<!-- AllowAddProvisioningPackage-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- AllowAddProvisioningPackage-Applicability-End -->

<!-- AllowAddProvisioningPackage-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/AllowAddProvisioningPackage
```
<!-- AllowAddProvisioningPackage-OmaUri-End -->

<!-- AllowAddProvisioningPackage-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether to allow the runtime configuration agent to install provisioning packages.
<!-- AllowAddProvisioningPackage-Description-End -->

<!-- AllowAddProvisioningPackage-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- AllowAddProvisioningPackage-Editable-End -->

<!-- AllowAddProvisioningPackage-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 1 |
<!-- AllowAddProvisioningPackage-DFProperties-End -->

<!-- AllowAddProvisioningPackage-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 | Not allowed. |
| 1 (Default) | Allowed. |
<!-- AllowAddProvisioningPackage-AllowedValues-End -->

<!-- AllowAddProvisioningPackage-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- AllowAddProvisioningPackage-Examples-End -->

<!-- AllowAddProvisioningPackage-End -->

<!-- AllowManualRootCertificateInstallation-Begin -->
## AllowManualRootCertificateInstallation

> [!NOTE]
> This policy is deprecated and may be removed in a future release.

<!-- AllowManualRootCertificateInstallation-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- AllowManualRootCertificateInstallation-Applicability-End -->

<!-- AllowManualRootCertificateInstallation-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/AllowManualRootCertificateInstallation
```
<!-- AllowManualRootCertificateInstallation-OmaUri-End -->

<!-- AllowManualRootCertificateInstallation-Description-Begin -->
<!-- Description-Source-DDF -->
This policy is deprecated.
<!-- AllowManualRootCertificateInstallation-Description-End -->

<!-- AllowManualRootCertificateInstallation-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- AllowManualRootCertificateInstallation-Editable-End -->

<!-- AllowManualRootCertificateInstallation-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 1 |
<!-- AllowManualRootCertificateInstallation-DFProperties-End -->

<!-- AllowManualRootCertificateInstallation-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 | Not allowed. |
| 1 (Default) | Allowed. |
<!-- AllowManualRootCertificateInstallation-AllowedValues-End -->

<!-- AllowManualRootCertificateInstallation-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- AllowManualRootCertificateInstallation-Examples-End -->

<!-- AllowManualRootCertificateInstallation-End -->

<!-- AllowRemoveProvisioningPackage-Begin -->
## AllowRemoveProvisioningPackage

<!-- AllowRemoveProvisioningPackage-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- AllowRemoveProvisioningPackage-Applicability-End -->

<!-- AllowRemoveProvisioningPackage-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/AllowRemoveProvisioningPackage
```
<!-- AllowRemoveProvisioningPackage-OmaUri-End -->

<!-- AllowRemoveProvisioningPackage-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether to allow the runtime configuration agent to remove provisioning packages.
<!-- AllowRemoveProvisioningPackage-Description-End -->

<!-- AllowRemoveProvisioningPackage-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- AllowRemoveProvisioningPackage-Editable-End -->

<!-- AllowRemoveProvisioningPackage-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 1 |
<!-- AllowRemoveProvisioningPackage-DFProperties-End -->

<!-- AllowRemoveProvisioningPackage-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 | Not allowed. |
| 1 (Default) | Allowed. |
<!-- AllowRemoveProvisioningPackage-AllowedValues-End -->

<!-- AllowRemoveProvisioningPackage-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- AllowRemoveProvisioningPackage-Examples-End -->

<!-- AllowRemoveProvisioningPackage-End -->

<!-- AntiTheftMode-Begin -->
## AntiTheftMode

> [!NOTE]
> This policy is deprecated and may be removed in a future release.

<!-- AntiTheftMode-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- AntiTheftMode-Applicability-End -->

<!-- AntiTheftMode-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/AntiTheftMode
```
<!-- AntiTheftMode-OmaUri-End -->

<!-- AntiTheftMode-Description-Begin -->
<!-- Description-Source-DDF -->
This policy is deprecated.
<!-- AntiTheftMode-Description-End -->

<!-- AntiTheftMode-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- AntiTheftMode-Editable-End -->

<!-- AntiTheftMode-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 1 |
<!-- AntiTheftMode-DFProperties-End -->

<!-- AntiTheftMode-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 | Disabled. |
| 1 (Default) | Enabled. |
<!-- AntiTheftMode-AllowedValues-End -->

<!-- AntiTheftMode-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- AntiTheftMode-Examples-End -->

<!-- AntiTheftMode-End -->

<!-- ClearTPMIfNotReady-Begin -->
## ClearTPMIfNotReady

<!-- ClearTPMIfNotReady-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1709 [10.0.16299] and later |
<!-- ClearTPMIfNotReady-Applicability-End -->

<!-- ClearTPMIfNotReady-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/ClearTPMIfNotReady
```
<!-- ClearTPMIfNotReady-OmaUri-End -->

<!-- ClearTPMIfNotReady-Description-Begin -->
<!-- Description-Source-ADMX -->
This policy setting configures the system to prompt the user to clear the TPM if the TPM is detected to be in any state other than Ready. This policy will take effect only if the system's TPM is in a state other than Ready, including if the TPM is "Ready, with reduced functionality". The prompt to clear the TPM will start occurring after the next reboot, upon user login only if the logged in user is part of the Administrators group for the system. The prompt can be dismissed, but will reappear after every reboot and login until the policy is disabled or until the TPM is in a Ready state.
<!-- ClearTPMIfNotReady-Description-End -->

<!-- ClearTPMIfNotReady-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- ClearTPMIfNotReady-Editable-End -->

<!-- ClearTPMIfNotReady-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- ClearTPMIfNotReady-DFProperties-End -->

<!-- ClearTPMIfNotReady-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Will not force recovery from a non-ready TPM state. |
| 1 | Will prompt to clear the TPM if the TPM is in a non-ready state (or reduced functionality) which can be remediated with a TPM Clear. |
<!-- ClearTPMIfNotReady-AllowedValues-End -->

<!-- ClearTPMIfNotReady-GpMapping-Begin -->
**Group policy mapping**:

| Name | Value |
|:--|:--|
| Name | ClearTPMIfNotReady_Name |
| Friendly Name | Configure the system to clear the TPM if it is not in a ready state. |
| Location | Computer Configuration |
| Path | System > Trusted Platform Module Services |
| Registry Key Name | Software\Policies\Microsoft\TPM |
| Registry Value Name | ClearTPMIfNotReadyGP |
| ADMX File Name | TPM.admx |
<!-- ClearTPMIfNotReady-GpMapping-End -->

<!-- ClearTPMIfNotReady-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- ClearTPMIfNotReady-Examples-End -->

<!-- ClearTPMIfNotReady-End -->

<!-- ConfigureWindowsPasswords-Begin -->
## ConfigureWindowsPasswords

<!-- ConfigureWindowsPasswords-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1803 [10.0.17134] and later |
<!-- ConfigureWindowsPasswords-Applicability-End -->

<!-- ConfigureWindowsPasswords-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/ConfigureWindowsPasswords
```
<!-- ConfigureWindowsPasswords-OmaUri-End -->

<!-- ConfigureWindowsPasswords-Description-Begin -->
<!-- Description-Source-DDF -->
Configures the use of passwords for Windows features.
<!-- ConfigureWindowsPasswords-Description-End -->

<!-- ConfigureWindowsPasswords-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
> [!NOTE]
> This policy is only supported in [Windows 10 S](/windows/deployment/s-mode).
<!-- ConfigureWindowsPasswords-Editable-End -->

<!-- ConfigureWindowsPasswords-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 2 |
<!-- ConfigureWindowsPasswords-DFProperties-End -->

<!-- ConfigureWindowsPasswords-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 | Disallow passwords (Asymmetric credentials will be promoted to replace passwords on Windows features). |
| 1 | Allow passwords (Passwords continue to be allowed to be used for Windows features). |
| 2 (Default) | As per SKU and device capabilities. Windows 10 S devices will exhibit "Disallow passwords" default, and all other devices will default to "Allow passwords"). |
<!-- ConfigureWindowsPasswords-AllowedValues-End -->

<!-- ConfigureWindowsPasswords-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- ConfigureWindowsPasswords-Examples-End -->

<!-- ConfigureWindowsPasswords-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Begin -->
## PreventAutomaticDeviceEncryptionForAzureADJoinedDevices

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1607 [10.0.14393] and later |
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Applicability-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/PreventAutomaticDeviceEncryptionForAzureADJoinedDevices
```
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-OmaUri-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether to allow automatic device encryption during OOBE when the device is Microsoft Entra joined.
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Description-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->

For more information, see [BitLocker Device Encryption](/windows/security/information-protection/bitlocker/bitlocker-device-encryption-overview-windows-10#bitlocker-device-encryption)
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Editable-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-DFProperties-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Encryption enabled. |
| 1 | Encryption disabled. |
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-AllowedValues-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-Examples-End -->

<!-- PreventAutomaticDeviceEncryptionForAzureADJoinedDevices-End -->

<!-- RecoveryEnvironmentAuthentication-Begin -->
## RecoveryEnvironmentAuthentication

<!-- RecoveryEnvironmentAuthentication-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ✅ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
<!-- RecoveryEnvironmentAuthentication-Applicability-End -->

<!-- RecoveryEnvironmentAuthentication-OmaUri-Begin -->
```User
./User/Vendor/MSFT/Policy/Config/Security/RecoveryEnvironmentAuthentication
```

```Device
./Device/Vendor/MSFT/Policy/Config/Security/RecoveryEnvironmentAuthentication
```
<!-- RecoveryEnvironmentAuthentication-OmaUri-End -->

<!-- RecoveryEnvironmentAuthentication-Description-Begin -->
<!-- Description-Source-DDF -->
This policy controls the requirement of Admin Authentication in RecoveryEnvironment.
<!-- RecoveryEnvironmentAuthentication-Description-End -->

<!-- RecoveryEnvironmentAuthentication-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
**Validation procedure**:

To validate this policy, check whether Refresh ("Keep my files") and Reset ("Remove everything") require administrator authentication in Windows Recovery Environment (WinRE).

1. First, start Push Button Reset (PBR) in WinRE. Open a command prompt as an administrator and run the following command: `reagentc /boottore`
1. The device should restart to WinRE. In the WinRE interface, go to **Troubleshoot** and select **Reset this PC**. You should see two options: **Keep my files** and **Remove everything**.
1. Choose the option to **Keep my files**. View the behavior for authentication.
1. Select the back arrow and choose **Remove everything**. View the behavior for authentication.

Instead of going back, alternatively you can go through the reset options, and select **Cancel** on the final confirmation page. It will then return to the main WinRE interface.

The following table shows what behavior is expected for the policy settings with each scenario:

- :heavy_check_mark: It prompts for authentication.
- :x: No authentication required, and it continues with the reset options.

| Policy                         | **Keep my files**  | **Remove everything** |
|--------------------------------|--------------------|-----------------------|
| Default (`0`)                  | :heavy_check_mark: | :x:                   |
| RequireAuthentication" (`1`)   | :heavy_check_mark: | :heavy_check_mark:    |
| NoRequireAuthentication" (`2`) | :x:                | :x:                   |
<!-- RecoveryEnvironmentAuthentication-Editable-End -->

<!-- RecoveryEnvironmentAuthentication-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- RecoveryEnvironmentAuthentication-DFProperties-End -->

<!-- RecoveryEnvironmentAuthentication-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Current) behavior. |
| 1 | RequireAuthentication: Admin Authentication is always required for components in RecoveryEnvironment. |
| 2 | NoRequireAuthentication: Admin Authentication isn't required for components in RecoveryEnvironment. |
<!-- RecoveryEnvironmentAuthentication-AllowedValues-End -->

<!-- RecoveryEnvironmentAuthentication-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- RecoveryEnvironmentAuthentication-Examples-End -->

<!-- RecoveryEnvironmentAuthentication-End -->

<!-- RequireDeviceEncryption-Begin -->
## RequireDeviceEncryption

<!-- RequireDeviceEncryption-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1607 [10.0.14393] and later |
<!-- RequireDeviceEncryption-Applicability-End -->

<!-- RequireDeviceEncryption-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/RequireDeviceEncryption
```
<!-- RequireDeviceEncryption-OmaUri-End -->

<!-- RequireDeviceEncryption-Description-Begin -->
<!-- Description-Source-DDF -->
Allows enterprise to turn on internal storage encryption. Most restricted value is 1. Important. If encryption has been enabled, it can't be turned off by using this policy.
<!-- RequireDeviceEncryption-Description-End -->

<!-- RequireDeviceEncryption-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- RequireDeviceEncryption-Editable-End -->

<!-- RequireDeviceEncryption-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- RequireDeviceEncryption-DFProperties-End -->

<!-- RequireDeviceEncryption-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Encryption isn't required. |
| 1 | Encryption is required. |
<!-- RequireDeviceEncryption-AllowedValues-End -->

<!-- RequireDeviceEncryption-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- RequireDeviceEncryption-Examples-End -->

<!-- RequireDeviceEncryption-End -->

<!-- RequireProvisioningPackageSignature-Begin -->
## RequireProvisioningPackageSignature

<!-- RequireProvisioningPackageSignature-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- RequireProvisioningPackageSignature-Applicability-End -->

<!-- RequireProvisioningPackageSignature-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/RequireProvisioningPackageSignature
```
<!-- RequireProvisioningPackageSignature-OmaUri-End -->

<!-- RequireProvisioningPackageSignature-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether provisioning packages must have a certificate signed by a device trusted authority.
<!-- RequireProvisioningPackageSignature-Description-End -->

<!-- RequireProvisioningPackageSignature-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- RequireProvisioningPackageSignature-Editable-End -->

<!-- RequireProvisioningPackageSignature-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- RequireProvisioningPackageSignature-DFProperties-End -->

<!-- RequireProvisioningPackageSignature-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Not required. |
| 1 | Required. |
<!-- RequireProvisioningPackageSignature-AllowedValues-End -->

<!-- RequireProvisioningPackageSignature-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- RequireProvisioningPackageSignature-Examples-End -->

<!-- RequireProvisioningPackageSignature-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-Begin -->
## RequireRetrieveHealthCertificateOnBoot

<!-- RequireRetrieveHealthCertificateOnBoot-Applicability-Begin -->
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device <br> ❌ User | ✅ Pro <br> ✅ Enterprise <br> ✅ Education <br> ✅ Windows SE <br> ✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
<!-- RequireRetrieveHealthCertificateOnBoot-Applicability-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-OmaUri-Begin -->
```Device
./Device/Vendor/MSFT/Policy/Config/Security/RequireRetrieveHealthCertificateOnBoot
```
<!-- RequireRetrieveHealthCertificateOnBoot-OmaUri-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-Description-Begin -->
<!-- Description-Source-DDF -->
Specifies whether to retrieve and post TCG Boot logs, and get or cache an encrypted or signed Health Attestation Report from the Microsoft Health Attestation Service (HAS) when a device boots or reboots. Setting this policy to 1 (Required):Determines whether a device is capable of Remote Device Health Attestation, by verifying if the device has TPM 2. 0. Improves the performance of the device by enabling the device to fetch and cache data to reduce the latency during Device Health Verification.

> [!NOTE]
> We recommend that this policy is set to Required after MDM enrollment. Most restricted value is 1.
<!-- RequireRetrieveHealthCertificateOnBoot-Description-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-Editable-Begin -->
<!-- Add any additional information about this policy here. Anything outside this section will get overwritten. -->
<!-- RequireRetrieveHealthCertificateOnBoot-Editable-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-DFProperties-Begin -->
**Description framework properties**:

| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Add, Delete, Get, Replace |
| Default Value  | 0 |
<!-- RequireRetrieveHealthCertificateOnBoot-DFProperties-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-AllowedValues-Begin -->
**Allowed values**:

| Value | Description |
|:--|:--|
| 0 (Default) | Not required. |
| 1 | Required. |
<!-- RequireRetrieveHealthCertificateOnBoot-AllowedValues-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-Examples-Begin -->
<!-- Add any examples for this policy here. Examples outside this section will get overwritten. -->
<!-- RequireRetrieveHealthCertificateOnBoot-Examples-End -->

<!-- RequireRetrieveHealthCertificateOnBoot-End -->

<!-- Security-CspMoreInfo-Begin -->
<!-- Add any additional information about this CSP here. Anything outside this section will get overwritten. -->
<!-- Security-CspMoreInfo-End -->

<!-- Security-End -->

## Related articles

[Policy configuration service provider](policy-configuration-service-provider.md)