Policy CSP - DeliveryOptimization

Tip

This CSP contains ADMX-backed policies which require a special SyncML format to enable or disable. You must specify the data type in the SyncML as <Format>chr</Format>. For details, see Understanding ADMX-backed policies.

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.

Logo of Windows Insider.

Important

This CSP contains some settings that are under development and only applicable for Windows Insider Preview builds. These settings are subject to change and may have dependencies on other features or services in preview.

DOAbsoluteMaxCacheSize

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1607 [10.0.14393] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOAbsoluteMaxCacheSize

Specifies the maximum size in GB of Delivery Optimization cache.

This policy overrides the DOMaxCacheSize policy.

The value 0 (zero) means "unlimited" cache; Delivery Optimization will clear the cache when the device runs low on disk space.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name AbsoluteMaxCacheSize
Friendly Name Absolute Max Cache Size (in GB)
Element Name Absolute Max Cache Size (in GB)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOAllowVPNPeerCaching

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1703 [10.0.15063] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOAllowVPNPeerCaching

Specifies whether the device is allowed to participate in Peer Caching while connected via VPN to the domain network. This means the device can download from or upload to other domain network devices, either on VPN or on the corporate domain network.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) Not allowed.
1 Allowed.

Group policy mapping:

Name Value
Name AllowVPNPeerCaching
Friendly Name Enable Peer Caching while the device connects via VPN
Element Name Enable Peer Caching while the device connects via VPN.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOCacheHost

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1709 [10.0.16299] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOCacheHost

This policy allows you to set one or more Microsoft Connected Cache servers that will be used by your client(s).

One or more values can be added as either fully qualified domain names (FQDN) or IP addresses. To add multiple values, separate each FQDN or IP address by commas.

Note

Clients don't talk to multiple Microsoft Connected Cache (MCC) servers at the same time. If you configure a list of MCC servers in this policy, the clients will round robin until they successfully connect to an MCC server. The clients have no way to determine if the MCC server has the content or not. If the MCC server doesn't have the content, it caches the content as it is handing the content back to the client.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace
Allowed Values List (Delimiter: ,)

Group policy mapping:

Name Value
Name CacheHost
Friendly Name Cache Server Hostname
Element Name Cache Server.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOCacheHostSource

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 2004 [10.0.19041] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOCacheHostSource

This policy allows you to specify how your client(s) can discover Microsoft Connected Cache servers dynamically.

Options available are:

0 = Disable DNS-SD.

1 = DHCP Option 235.

2 = DHCP Option 235 Force.

If this policy isn't configured, the client will attempt to automatically find a cache server using DNS-SD. If set to 0, the client won't use DNS-SD to automatically find a cache server. If set to 1 or 2, the client will query DHCP Option ID 235 and use the returned value as the Cache Server Hostname. Option 2 overrides the Cache Server Hostname policy, if configured.

Note

If the DHCP Option ID is formatted incorrectly, the client will fall back to the Cache Server Hostname policy value if that value has been set.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name CacheHostSource
Friendly Name Cache Server Hostname Source
Element Name Cache Server Hostname Source.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DODelayBackgroundDownloadFromHttp

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODelayBackgroundDownloadFromHttp

This policy allows you to delay the use of an HTTP source in a background download that's allowed to use P2P.

After the max delay has reached, the download will resume using HTTP, either downloading the entire payload or complementing the bytes that couldn't be downloaded from Peers.

Note that a download that's waiting for peer sources, will appear to be stuck for the end user.

The recommended value is 1 hour (3600).

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name DelayBackgroundDownloadFromHttp
Friendly Name Delay background download from http (in secs)
Element Name Delay background download from http (in secs)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DODelayCacheServerFallbackBackground

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1903 [10.0.18362] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODelayCacheServerFallbackBackground

Specifies the time in seconds to delay the fallback from Cache Server to the HTTP source for a background content download. Note that the DODelayBackgroundDownloadFromHttp policy takes precedence over this policy to allow downloads from peers first.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-2592000]
Default Value 0

Group policy mapping:

Name Value
Name DelayCacheServerFallbackBackground
Friendly Name Delay Background download Cache Server fallback (in seconds)
Element Name Delay Background download Cache Server fallback (in secs)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DODelayCacheServerFallbackForeground

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1903 [10.0.18362] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODelayCacheServerFallbackForeground

Specifies the time in seconds to delay the fallback from Cache Server to the HTTP source for foreground content download. Note that the DODelayForegroundDownloadFromHttp policy takes precedence over this policy to allow downloads from peers first.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-2592000]
Default Value 0

Group policy mapping:

Name Value
Name DelayCacheServerFallbackForeground
Friendly Name Delay Foreground download Cache Server fallback (in seconds)
Element Name Delay Foreground download Cache Server fallback (in secs)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DODelayForegroundDownloadFromHttp

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODelayForegroundDownloadFromHttp

This policy allows you to delay the use of an HTTP source in a foreground (interactive) download that's allowed to use P2P.

After the max delay has reached, the download will resume using HTTP, either downloading the entire payload or complementing the bytes that couldn't be downloaded from Peers.

Note that a download that's waiting for peer sources, will appear to be stuck for the end user.

The recommended value is 1 minute (60).

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name DelayForegroundDownloadFromHttp
Friendly Name Delay Foreground download from http (in secs)
Element Name Delay Foreground download from http (in secs)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DODisallowCacheServerDownloadsOnVPN

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 11, version 22H2 [10.0.22621.2361] and later
✅ Windows Insider Preview
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODisallowCacheServerDownloadsOnVPN

Disallow downloads from Microsoft Connected Cache servers when the device connects via VPN. By default, the device is allowed to download from Microsoft Connected Cache when connected via VPN.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) Allowed.
1 Not allowed.

Group policy mapping:

Name Value
Name AllowCacheHostWithVPN
Path DeliveryOptimization > AT > WindowsComponents > DeliveryOptimizationCat
Element Name DisallowCacheServerDownloadsOnVPN

DODownloadMode

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1507 [10.0.10240] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DODownloadMode

Specifies the download method that Delivery Optimization can use in downloads of Windows Updates, Apps and App updates. The default value is 1.

Note

The Delivery Optimization service on the clients checks to see if there are peers and/or an MCC server which contains the content and determines the best source for the content.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) HTTP only, no peering.
1 HTTP blended with peering behind the same NAT.
2 When this option is selected, peering will cross NATs. To create a custom group use Group ID in combination with Mode 2.
3 HTTP blended with Internet peering.
99 Simple download mode with no peering. Delivery Optimization downloads using HTTP only and doesn't attempt to contact the Delivery Optimization cloud services. Added in Windows 10, version 1607.
100 Bypass mode. Windows 10: Don't use Delivery Optimization and use BITS instead. Windows 11: Deprecated, use Simple mode instead.

Group policy mapping:

Name Value
Name DownloadMode
Friendly Name Download Mode
Element Name Download Mode.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOGroupId

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1607 [10.0.14393] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOGroupId

Group ID must be set as a GUID. This Policy specifies an arbitrary group ID that the device belongs to.

Use this if you need to create a single group for Local Network Peering for branches that are on different domains or aren't on the same LAN.

Note this is a best effort optimization and shouldn't be relied on for an authentication of identity.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace

Group policy mapping:

Name Value
Name GroupId
Friendly Name Group ID
Element Name Group ID.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOGroupIdSource

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOGroupIdSource

Set this policy to restrict peer selection to a specific source. Available options are: 1 = AD Site, 2 = Authenticated domain SID, 3 = DHCP Option ID, 4 = DNS Suffix, 5 = Microsoft Entra ID. When set, the Group ID will be assigned automatically from the selected source. This policy is ignored if the GroupID policy is also set. The options set in this policy only apply to Group (2) download mode. If Group (2) isn't set as Download mode, this policy will be ignored. For option 3 - DHCP Option ID, the client will query DHCP Option ID 234 and use the returned GUID value as the Group ID. Starting with Windows 10, version 1903, you can use the Microsoft Entra tenant ID as a means to define groups. To do this, set the value of DOGroupIdSource to 5.

Note

The default behavior, when neither the DOGroupId or DOGroupIdSource policies are set, is to determine the Group ID using AD Site (1), Authenticated domain SID (2) or Microsoft Entra tenant ID (5), in that order. If DOGroupIdSource is set to either DHCP Option ID (3) or DNS Suffix (4) and those methods fail, the default behavior is used instead.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) Unset.
1 AD site.
2 Authenticated domain SID.
3 DHCP user option.
4 DNS suffix.
5 Microsoft Entra ID.

Group policy mapping:

Name Value
Name GroupIdSource
Friendly Name Select the source of Group IDs
Element Name Source of Group IDs.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMaxBackgroundDownloadBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 2004 [10.0.19041] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMaxBackgroundDownloadBandwidth

Specifies the maximum background download bandwidth in KiloBytes/second that the device can use across all concurrent download activities using Delivery Optimization.

The default value 0 (zero) means that Delivery Optimization dynamically adjusts to use the available bandwidth for downloads.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name MaxBackgroundDownloadBandwidth
Friendly Name Maximum Background Download Bandwidth (in KB/s)
Element Name Maximum Background Download Bandwidth (in KB/s)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMaxCacheAge

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1507 [10.0.10240] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMaxCacheAge

Specifies the maximum time in seconds that each file is held in the Delivery Optimization cache after downloading successfully. The value 0 (zero) means unlimited; Delivery Optimization will hold the files in the cache longer and make the files available for uploads to other devices, as long as the cache size hasn't exceeded. The value 0 is new in Windows 10, version 1607. The default value is 604800 seconds (7 days).

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name MaxCacheAge
Friendly Name Max Cache Age (in seconds)
Element Name Max Cache Age (in seconds)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMaxCacheSize

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1507 [10.0.10240] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMaxCacheSize

Specifies the maximum cache size that Delivery Optimization can utilize, as a percentage of disk size (1-100). The default value is 20.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [1-100]
Default Value 0

Group policy mapping:

Name Value
Name MaxCacheSize
Friendly Name Max Cache Size (percentage)
Element Name Max Cache Size (Percentage)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMaxForegroundDownloadBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 2004 [10.0.19041] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMaxForegroundDownloadBandwidth

Specifies the maximum foreground download bandwidth in KiloBytes/second that the device can use across all concurrent download activities using Delivery Optimization.

The default value 0 (zero) means that Delivery Optimization dynamically adjusts to use the available bandwidth for downloads.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name MaxForegroundDownloadBandwidth
Friendly Name Maximum Foreground Download Bandwidth (in KB/s)
Element Name Maximum Foreground Download Bandwidth (in KB/s)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMinBackgroundQos

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1607 [10.0.14393] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMinBackgroundQos

Specifies the minimum download QoS (Quality of Service or speed) in KiloBytes/sec for background downloads. This policy affects the blending of peer and HTTP sources. Delivery Optimization complements the download from the HTTP source to achieve the minimum QoS value set. The default value is 20480 (20 MB/s).

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [1-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name MinBackgroundQos
Friendly Name Minimum Background QoS (in KB/s)
Element Name Minimum Background QoS (in KB/s)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMinBatteryPercentageAllowedToUpload

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1703 [10.0.15063] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMinBatteryPercentageAllowedToUpload

Specify any value between 1 and 100 (in percentage) to allow the device to upload data to LAN and Group peers while on DC power (Battery).

The recommended value to set if you allow uploads on battery is 40 (for 40%). The device can download from peers while on battery regardless of this policy.

The value 0 means "not-limited"; The cloud service set default value will be used.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-100]
Default Value 0

Group policy mapping:

Name Value
Name MinBatteryPercentageAllowedToUpload
Friendly Name Allow uploads while the device is on battery while under set Battery level (percentage)
Element Name Minimum battery level (Percentage)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMinDiskSizeAllowedToPeer

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1703 [10.0.15063] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMinDiskSizeAllowedToPeer

Specifies the required minimum disk size (capacity in GB) for the device to use Peer Caching. The cloud service set default value will be used.

Recommended values: 64 GB to 256 GB.

Note

If the DOModifyCacheDrive policy is set, the disk size check will apply to the new working directory specified by this policy.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [1-100000]
Default Value 0

Group policy mapping:

Name Value
Name MinDiskSizeAllowedToPeer
Friendly Name Minimum disk size allowed to use Peer Caching (in GB)
Element Name Minimum disk size allowed to use Peer Caching (in GB)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMinFileSizeToCache

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1703 [10.0.15063] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMinFileSizeToCache

Specifies the minimum content file size in MB enabled to use Peer Caching. Recommended values: 1 MB to 100,000 MB. The default value is 100 MB.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [1-100000]
Default Value 0

Group policy mapping:

Name Value
Name MinFileSizeToCache
Friendly Name Minimum Peer Caching Content File Size (in MB)
Element Name Minimum Peer Caching Content File Size (in MB)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMinRAMAllowedToPeer

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1703 [10.0.15063] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMinRAMAllowedToPeer

Specifies the minimum RAM size in GB required to use Peer Caching. For example, if the minimum set is 1 GB, then devices with 1 GB or higher available RAM will be allowed to use Peer caching. Recommended values: 1 GB to 4 GB. The default value is 4 GB.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [1-100000]
Default Value 0

Group policy mapping:

Name Value
Name MinRAMAllowedToPeer
Friendly Name Minimum RAM capacity (inclusive) required to enable use of Peer Caching (in GB)
Element Name Minimum RAM capacity (inclusive) required to enable use of Peer Caching (in GB)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOModifyCacheDrive

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1607 [10.0.14393] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOModifyCacheDrive

Specifies the drive Delivery Optimization shall use for its cache.

By default, %SystemDrive% is used to store the cache. The drive location can be specified using environment variables, drive letter or using a full path.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace

Group policy mapping:

Name Value
Name ModifyCacheDrive
Friendly Name Modify Cache Drive
Element Name Modify Cache Drive.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOMonthlyUploadDataCap

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1607 [10.0.14393] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOMonthlyUploadDataCap

Specifies the maximum total bytes in GB that Delivery Optimization is allowed to upload to Internet peers in each calendar month. The value 0 (zero) means unlimited; No monthly upload limit's applied if 0 is set. The default value is 5120 (5 TB).

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-4294967295]
Default Value 0

Group policy mapping:

Name Value
Name MonthlyUploadDataCap
Friendly Name Monthly Upload Data Cap (in GB)
Element Name Monthly Upload Data Cap (in GB)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOPercentageMaxBackgroundBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOPercentageMaxBackgroundBandwidth

Specifies the maximum background download bandwidth that Delivery Optimization uses across all concurrent download activities as a percentage of available download bandwidth.

The default value 0 (zero) means that Delivery Optimization dynamically adjusts to use the available bandwidth for background downloads.

Downloads from LAN peers won't be throttled even when this policy is set.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-100]
Default Value 0

Group policy mapping:

Name Value
Name PercentageMaxBackgroundBandwidth
Friendly Name Maximum Background Download Bandwidth (percentage)
Element Name Maximum Background Download Bandwidth (Percentage)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOPercentageMaxForegroundBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOPercentageMaxForegroundBandwidth

Specifies the maximum foreground download bandwidth that Delivery Optimization uses across all concurrent download activities as a percentage of available download bandwidth.

The default value 0 (zero) means that Delivery Optimization dynamically adjusts to use the available bandwidth for foreground downloads.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Allowed Values Range: [0-100]
Default Value 0

Group policy mapping:

Name Value
Name PercentageMaxForegroundBandwidth
Friendly Name Maximum Foreground Download Bandwidth (percentage)
Element Name Maximum Foreground Download Bandwidth (Percentage)
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DORestrictPeerSelectionBy

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DORestrictPeerSelectionBy

Set this policy to restrict peer selection via selected option.

Options available are:

0 = NAT.

1 = Subnet mask.

2 = Local discovery (DNS-SD).

The default value has changed from 0 (no restriction) to 1 (restrict to the subnet).

These options apply to both Download Mode LAN (1) and Group (2).

If Group mode is set, Delivery Optimization will connect to locally discovered peers that are also part of the same Group (have the same Group ID).

In Windows 11 the 'Local Peer Discovery' option was introduced to restrict peer discovery to the local network. The default value in Windows 11 is set to 'Local Peer Discovery'. The Local Peer Discovery (DNS-SD) option can only be set via MDM delivered policies on Windows 11 builds.

Description framework properties:

Property name Property value
Format int
Access Type Add, Delete, Get, Replace
Default Value 0

Allowed values:

Value Description
0 (Default) None.
1 Subnet mask.
2 Local peer discovery (DNS-SD).

Group policy mapping:

Name Value
Name RestrictPeerSelectionBy
Friendly Name Select a method to restrict Peer Selection
Element Name Restrict Peer Selection By.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOSetHoursToLimitBackgroundDownloadBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOSetHoursToLimitBackgroundDownloadBandwidth

Specifies the maximum background download bandwidth that Delivery Optimization uses during and outside business hours across all concurrent download activities as a percentage of available download bandwidth.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace

Tip

This is an ADMX-backed policy and requires SyncML format for configuration. For an example of SyncML format, refer to Enabling a policy.

ADMX mapping:

Name Value
Name SetHoursToLimitBackgroundDownloadBandwidth
Friendly Name Set Business Hours to Limit Background Download Bandwidth
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOSetHoursToLimitForegroundDownloadBandwidth

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 10, version 1803 [10.0.17134] and later
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOSetHoursToLimitForegroundDownloadBandwidth

Specifies the maximum foreground download bandwidth that Delivery Optimization uses during and outside business hours across all concurrent download activities as a percentage of available download bandwidth.

This policy allows an IT Admin to define the following details:

  • Business hours range (for example 06:00 to 18:00)
  • % of throttle for background traffic during business hours
  • % of throttle for background traffic outside of business hours

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace

Tip

This is an ADMX-backed policy and requires SyncML format for configuration. For an example of SyncML format, refer to Enabling a policy.

ADMX mapping:

Name Value
Name SetHoursToLimitForegroundDownloadBandwidth
Friendly Name Set Business Hours to Limit Foreground Download Bandwidth
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

DOVpnKeywords

Scope Editions Applicable OS
✅ Device
❌ User
✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC
✅ Windows 11, version 22H2 [10.0.22621.2361] and later
✅ Windows Insider Preview
./Device/Vendor/MSFT/Policy/Config/DeliveryOptimization/DOVpnKeywords

This policy allows you to set one or more keywords used to recognize VPN connections. To add multiple keywords, separate them with commas.

Description framework properties:

Property name Property value
Format chr (string)
Access Type Add, Delete, Get, Replace
Allowed Values List (Delimiter: ,)

Group policy mapping:

Name Value
Name VpnKeywords
Friendly Name VPN Keywords
Element Name VPN Keywords.
Location Computer Configuration
Path Windows Components > Delivery Optimization
Registry Key Name SOFTWARE\Policies\Microsoft\Windows\DeliveryOptimization
ADMX File Name DeliveryOptimization.admx

Policy configuration service provider