windows-itpro-docs/windows/client-management/mdm/policy-csp-deliveryoptimization.md
2017-11-01 19:46:45 +00:00

28 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 11/01/2017

Policy CSP - DeliveryOptimization


DeliveryOptimization policies

DeliveryOptimization/DOAbsoluteMaxCacheSize
DeliveryOptimization/DOAllowVPNPeerCaching
DeliveryOptimization/DODownloadMode
DeliveryOptimization/DOGroupId
DeliveryOptimization/DOMaxCacheAge
DeliveryOptimization/DOMaxCacheSize
DeliveryOptimization/DOMaxDownloadBandwidth
DeliveryOptimization/DOMaxUploadBandwidth
DeliveryOptimization/DOMinBackgroundQos
DeliveryOptimization/DOMinBatteryPercentageAllowedToUpload
DeliveryOptimization/DOMinDiskSizeAllowedToPeer
DeliveryOptimization/DOMinFileSizeToCache
DeliveryOptimization/DOMinRAMAllowedToPeer
DeliveryOptimization/DOModifyCacheDrive
DeliveryOptimization/DOMonthlyUploadDataCap
DeliveryOptimization/DOPercentageMaxDownloadBandwidth

**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.


**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.

The default value is 0 (FALSE).


**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.

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.


**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).


**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.


**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.


**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).


**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.


**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.


**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.


**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.


**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.


**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.


**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.


**DeliveryOptimization/DOPercentageMaxDownloadBandwidth**
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 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 downloads.


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