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

47 KiB
Raw Blame History

title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date
title description ms.author ms.topic ms.prod ms.technology author ms.date
Policy CSP - DeliveryOptimization Policy CSP - DeliveryOptimization maricia article w10 windows nickbrower 03/05/2018

Policy CSP - DeliveryOptimization

Warning

Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.


DeliveryOptimization policies

DeliveryOptimization/DOAbsoluteMaxCacheSize
DeliveryOptimization/DOAllowVPNPeerCaching
DeliveryOptimization/DODelayBackgroundDownloadFromHttp
DeliveryOptimization/DODelayForegroundDownloadFromHttp
DeliveryOptimization/DODownloadMode
DeliveryOptimization/DOGroupId
DeliveryOptimization/DOGroupIdSource
DeliveryOptimization/DOMaxCacheAge
DeliveryOptimization/DOMaxCacheSize
DeliveryOptimization/DOMaxDownloadBandwidth
DeliveryOptimization/DOMaxUploadBandwidth
DeliveryOptimization/DOMinBackgroundQos
DeliveryOptimization/DOMinBatteryPercentageAllowedToUpload
DeliveryOptimization/DOMinDiskSizeAllowedToPeer
DeliveryOptimization/DOMinFileSizeToCache
DeliveryOptimization/DOMinRAMAllowedToPeer
DeliveryOptimization/DOModifyCacheDrive
DeliveryOptimization/DOMonthlyUploadDataCap
DeliveryOptimization/DOPercentageMaxBackgroundBandwidth
DeliveryOptimization/DOPercentageMaxDownloadBandwidth
DeliveryOptimization/DOPercentageMaxForegroundBandwidth
DeliveryOptimization/DORestrictPeerSelectionBy
DeliveryOptimization/DOSetHoursToLimitBackgroundDownloadBandwidth
DeliveryOptimization/DOSetHoursToLimitForegroundDownloadBandwidth

DeliveryOptimization/DOAbsoluteMaxCacheSize

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark1 check mark1 check mark1 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1607. 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 is running low on disk space.

The default value is 10.

ADMX Info:

  • GP English name: Absolute Max Cache Size (in GB)
  • GP name: AbsoluteMaxCacheSize
  • GP element: AbsoluteMaxCacheSize
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOAllowVPNPeerCaching

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark2 check mark2 check mark2 check mark2 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1703. 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.

ADMX Info:

  • GP English name: Enable Peer Caching while the device connects via VPN
  • GP name: AllowVPNPeerCaching
  • GP element: AllowVPNPeerCaching
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

The following list shows the supported values:

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

DeliveryOptimization/DODelayBackgroundDownloadFromHttp

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. This policy allows you to delay the use of an HTTP source in a background download that is allowed to use peer-to-peer.

After the max delay is reached, the download will resume using HTTP, either downloading the entire payload or complementing the bytes that could not be downloaded from peers. Note that a download that is waiting for peer sources, will appear to be stuck for the end user. The recommended value is 1 hour (3600).

ADMX Info:

  • GP English name: Delay background download from http (in secs)
  • GP name: DelayBackgroundDownloadFromHttp
  • GP element: DelayBackgroundDownloadFromHttp
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DODelayForegroundDownloadFromHttp

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. This policy allows you to delay the use of an HTTP source in a foreground (interactive) download that is allowed to use peer-to-peer.

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

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

The recommended value is 1 minute (60).

ADMX Info:

  • GP English name: Delay Foreground download from http (in secs)
  • GP name: DelayForegroundDownloadFromHttp
  • GP element: DelayForegroundDownloadFromHttp
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

The following list shows the supported values as number of seconds:

  • 0 to 86400 (1 day)
  • 0 - managed by the cloud service
  • Default is not configured.

DeliveryOptimization/DODownloadMode

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark check mark check mark cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

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

ADMX Info:

  • GP English name: Download Mode
  • GP name: DownloadMode
  • GP element: DownloadMode
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

The following list shows the supported values:

  • 0 HTTP only, no peering.
  • 1 (default) HTTP blended with peering behind the same NAT.
  • 2 HTTP blended with peering across a private group. Peering occurs on devices in the same Active Directory Site (if it exists) or the same domain by default. 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 does not attempt to contact the Delivery Optimization cloud services. Added in Windows 10, version 1607.
  • 100 - Bypass mode. Do not use Delivery Optimization and use BITS instead. Added in Windows 10, version 1607.

DeliveryOptimization/DOGroupId

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark check mark check mark cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

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 are not on the same LAN. Note that this is a best effort optimization and should not be relied on for an authentication of identity.

Note

 You must use a GUID as the group ID.

ADMX Info:

  • GP English name: Group ID
  • GP name: GroupId
  • GP element: GroupId
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOGroupIdSource

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. Set this policy to restrict peer selection to a specific source. Options available are: 1 = AD Site, 2 = Authenticated domain SID, 3 = DHCP Option ID, 4 = DNS Suffix

When set, the Group ID will be assigned automatically from the selected source.

If you set this policy, the GroupID policy will be ignored.

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 4 - DHCP Option ID, the client will query DHCP Option ID 234 and use the returned GUID value as the Group ID.

ADMX Info:

  • GP English name: Select the source of Group IDs
  • GP name: GroupIdSource
  • GP element: GroupIdSource
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

The following list shows the supported values:

  • 1 - AD site
  • 2 - Authenticated domain SID
  • 3 - DHCP user option
  • 4 - DNS suffix

DeliveryOptimization/DOMaxCacheAge

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark check mark check mark cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

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 has not exceeded. The value 0 is new in Windows 10, version 1607.

The default value is 259200 seconds (3 days).

ADMX Info:

  • GP English name: Max Cache Age (in seconds)
  • GP name: MaxCacheAge
  • GP element: MaxCacheAge
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMaxCacheSize

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark check mark check mark cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

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

The default value is 20.

ADMX Info:

  • GP English name: Max Cache Size (percentage)
  • GP name: MaxCacheSize
  • GP element: MaxCacheSize
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMaxDownloadBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark1 check mark1 check mark1 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1607. Specifies the maximum 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.

ADMX Info:

  • GP English name: Maximum Download Bandwidth (in KB/s)
  • GP name: MaxDownloadBandwidth
  • GP element: MaxDownloadBandwidth
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMaxUploadBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark check mark check mark cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

  Specifies the maximum upload bandwidth in KiloBytes/second that a device will use across all concurrent upload activity using Delivery Optimization.

The default value is 0, which permits unlimited possible bandwidth (optimized for minimal usage of upload bandwidth).

ADMX Info:

  • GP English name: Max Upload Bandwidth (in KB/s)
  • GP name: MaxUploadBandwidth
  • GP element: MaxUploadBandwidth
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMinBackgroundQos

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark1 check mark1 check mark1 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1607. 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 500.

ADMX Info:

  • GP English name: Minimum Background QoS (in KB/s)
  • GP name: MinBackgroundQos
  • GP element: MinBackgroundQos
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMinBatteryPercentageAllowedToUpload

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark2 check mark2 check mark2 check mark2 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1703. Specifies any value between 1 and 100 (in percentage) to allow the device to upload data to LAN and Group peers while on battery power. Uploads will automatically pause when the battery level drops below the set minimum battery level. The recommended value to set is 40 (for 40%) if you allow uploads on battery.

The default value is 0. The value 0 (zero) means "not limited" and the cloud service default value will be used.

ADMX Info:

  • GP English name: Allow uploads while the device is on battery while under set Battery level (percentage)
  • GP name: MinBatteryPercentageAllowedToUpload
  • GP element: MinBatteryPercentageAllowedToUpload
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMinDiskSizeAllowedToPeer

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark2 check mark2 check mark2 check mark2 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1703. Specifies the required minimum disk size (capacity in GB) for the device to use Peer Caching. The value 0 means "not-limited" which means the cloud service set default value will be used. Recommended values: 64 GB to 256 GB.

Note

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

The default value is 32 GB.

ADMX Info:

  • GP English name: Minimum disk size allowed to use Peer Caching (in GB)
  • GP name: MinDiskSizeAllowedToPeer
  • GP element: MinDiskSizeAllowedToPeer
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMinFileSizeToCache

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark2 check mark2 check mark2 check mark2 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1703. Specifies the minimum content file size in MB enabled to use Peer Caching. The value 0 means "unlimited" which means the cloud service set default value will be used. Recommended values: 1 MB to 100,000 MB.

The default value is 100 MB.

ADMX Info:

  • GP English name: Minimum Peer Caching Content File Size (in MB)
  • GP name: MinFileSizeToCache
  • GP element: MinFileSizeToCache
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMinRAMAllowedToPeer

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark2 check mark2 check mark2 check mark2 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1703. Specifies the minimum RAM size in GB required to use Peer Caching. The value 0 means "not-limited" which means the cloud service set default value will be used. 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.

ADMX Info:

  • GP English name: Minimum RAM capacity (inclusive) required to enable use of Peer Caching (in GB)
  • GP name: MinRAMAllowedToPeer
  • GP element: MinRAMAllowedToPeer
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOModifyCacheDrive

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark1 check mark1 check mark1 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1607. Specifies the drive that Delivery Optimization should use for its cache. The drive location can be specified using environment variables, drive letter or using a full path.

By default, %SystemDrive% is used to store the cache.

ADMX Info:

  • GP English name: Modify Cache Drive
  • GP name: ModifyCacheDrive
  • GP element: ModifyCacheDrive
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOMonthlyUploadDataCap

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark1 check mark1 check mark1 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Note

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

Added in Windows 10, version 1607. 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 is applied if 0 is set.

The default value is 20.

ADMX Info:

  • GP English name: Monthly Upload Data Cap (in GB)
  • GP name: MonthlyUploadDataCap
  • GP element: MonthlyUploadDataCap
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOPercentageMaxBackgroundBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. 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.

Note that downloads from LAN peers will not be throttled even when this policy is set.


DeliveryOptimization/DOPercentageMaxDownloadBandwidth

This policy is deprecated. Use DOPercentageMaxForegroundBandwidth and DOPercentageMaxBackgroundBandwidth policies instead.


DeliveryOptimization/DOPercentageMaxForegroundBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. 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.

Note that downloads from LAN peers will not be throttled even when this policy is set.


DeliveryOptimization/DORestrictPeerSelectionBy

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. Set this policy to restrict peer selection via selected option. Options available are: 1=Subnet mask (more options will be added in a future release).

Option 1 (Subnet mask) applies to both Download Mode LAN (1) and Group (2).

ADMX Info:

  • GP English name: Select a method to restrict Peer Selection
  • GP name: RestrictPeerSelectionBy
  • GP element: RestrictPeerSelectionBy
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

The following list shows the supported values:

  • 1 - Subnet mask.

DeliveryOptimization/DOSetHoursToLimitBackgroundDownloadBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. 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.

This policy allows an IT Admin to define the following:

  • 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

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 English name: Set Business Hours to Limit Background Download Bandwidth
  • GP name: SetHoursToLimitBackgroundDownloadBandwidth
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

DeliveryOptimization/DOSetHoursToLimitForegroundDownloadBandwidth

Home Pro Business Enterprise Education Mobile Mobile Enterprise
cross mark check mark4 check mark4 check mark4 check mark4 cross mark cross mark

Scope:

[!div class = "checklist"]

  • Device

Added in Windows 10, version 1803. 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:

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

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 English name: Set Business Hours to Limit Foreground Download Bandwidth
  • GP name: SetHoursToLimitForegroundDownloadBandwidth
  • GP path: Windows Components/Delivery Optimization
  • GP ADMX file name: DeliveryOptimization.admx

Footnote:

  • 1 - Added in Windows 10, version 1607.
  • 2 - Added in Windows 10, version 1703.
  • 3 - Added in Windows 10, version 1709.

DeliveryOptimization policies supported by Microsoft Surface Hub