命名空间：microsoft.graph
重要提示：Microsoft 支持 Intune/beta API，但它们可能会进行更频繁的更改。 Microsoft 建议尽可能使用 v1.0 版本。 使用版本选择器检查 API 在版本 v1.0 中的可用性。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
Windows 传递优化配置
方法
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 实体的键。 继承自 deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | 上次修改对象的日期/时间。 继承自 deviceConfiguration |
| roleScopeTagIds | 字符串集合 | 此实体实例的范围标记的列表。 继承自 deviceConfiguration |
| supportsScopeTags | 布尔值 | 指示基础设备配置是否支持分配范围标记。 如果此值为 false，则不允许分配给 ScopeTags 属性，并且实体对作用域用户不可见。 对于在 Silverlight 中创建的旧策略，会出现此问题，可以通过在 Azure 门户中删除并重新创建策略来解决。 此属性是只读的。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | 此策略的操作系统版本适用性。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | 此策略的操作系统版本适用性规则。 继承自 deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | 此策略的设备模式适用性规则。 继承自 deviceConfiguration |
| createdDateTime | DateTimeOffset | 创建对象的日期/时间。 继承自 deviceConfiguration |
| description | String | 管理员提供的设备配置的说明。 继承自 deviceConfiguration |
| displayName | String | 管理员提供的设备配置的名称。 继承自 deviceConfiguration |
| version | Int32 | 设备配置的版本。 继承自 deviceConfiguration |
| deliveryOptimizationMode | windowsDeliveryOptimizationMode | 指定传递优化可用于管理大型内容分发方案的网络带宽使用量的下载方法。 可取值为：userDefined、httpOnly、httpWithPeeringNat、httpWithPeeringPrivateGroup、httpWithInternetPeering、simpleDownload 或 bypassMode。 |
| restrictPeerSelectionBy | deliveryOptimizationRestrictPeerSelectionByOptions | 指定通过所选选项限制对等方选择。 |
选项 1 (子网掩码) 仅适用于传递优化模式、下载模式、LAN (1) 和组 (2) 。 可取值为：notConfigured、subnetMask。 |
||
| groupIdSource | deliveryOptimizationGroupIdSource | 指定将对等方选择限制为特定源。 |
| 此策略中设置的选项仅适用于传递优化模式组 (2) 下载模式。 如果未将“组 (2”) “设置为”下载“模式，则将忽略此策略。 对于选项 3 - DHCP 选项 ID，客户端将查询 DHCP 选项 ID 234，并使用返回的 GUID 值作为组 ID。 | ||
| bandwidthMode | deliveryOptimizationBandwidth | 使用百分比、绝对值或小时数指定前台和后台带宽使用情况。 |
| backgroundDownloadFromHttpDelayInSeconds | Int64 | 指定在允许使用对等的后台下载中延迟 HTTP 源的秒数。 有效值 0 到 4294967295 |
| foregroundDownloadFromHttpDelayInSeconds | Int64 | 指定允许使用点对点 (0-86400) 的前台下载中延迟 HTTP 源的秒数。 有效值 0 到 86400 |
| 指定 0 将传递优化设置为使用云服务管理此设置。 有效值 0 到 86400 | ||
| minimumRamAllowedToPeerInGigabytes | Int32 | 指定使用对等缓存的最小 RAM 大小（以 GB 为单位 (1-100000) 。 有效值 1 到 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | 指定使用对等缓存 (1-100000) 的最小磁盘大小（以 GB 为单位）。 有效值 1 到 100000 |
| 建议的值：64 GB 到 256 GB。 有效值 1 到 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | 指定启用以使用对等缓存 (1-100000) 的最小内容文件大小（以 MB 为单位）。 有效值 1 到 100000 |
| 推荐值：1 MB 至 100,000 MB。 有效值 1 到 100000 | ||
| minimumBatteryPercentageAllowedToUpload | Int32 | 指定允许设备 (0-100) 上传数据的最小电池百分比。 有效值为 0 至 100 |
| 默认值为 0。 值 0 (零) 表示“不受限制”，将使用云服务默认值。 有效值为 0 至 100 | ||
| modifyCacheLocation | String | 指定传递优化应对其缓存使用的驱动器。 |
| maximumCacheAgeInDays | Int32 | 指定成功下载后每个文件在 0-3650) 成功下载后 (每个文件保留在传递优化缓存中的最长时间（以天为单位）。 有效值 0 到 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | 以百分比或 GB 为单位指定传递优化的最大缓存大小。 |
| vpnPeerCaching | 启用 | 指定在通过 VPN 连接到域网络时是否允许设备参与对等缓存。 可取值为：notConfigured、enabled、disabled。 |
| cacheServerHostNames | 字符串集合 | 指定缓存服务器主机名。 |
| cacheServerForegroundDownloadFallbackToHttpDelayInSeconds | Int32 | 指定从缓存服务器回退到 HTTP 源以进行前台下载的延迟秒数。 有效值 0 到 2592000。 |
| cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds | Int32 | 指定延迟从缓存服务器回退到 HTTP 源以进行后台下载的秒数。 有效值 0 到 2592000。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| groupAssignments | deviceConfigurationGroupAssignment 集合 | 设备配置文件的组分配列表。 继承自 deviceConfiguration |
| assignments | deviceConfigurationAssignment 集合 | 设备配置文件的分配列表。 继承自 deviceConfiguration |
| deviceStatuses | deviceConfigurationDeviceStatus 集合 | 按设备的设备配置安装状态。 继承自 deviceConfiguration |
| userStatuses | deviceConfigurationUserStatus 集合 | 设备配置安装状态（按用户）。 继承自 deviceConfiguration |
| deviceStatusOverview | deviceConfigurationDeviceOverview | 设备配置设备状态概述 继承自 deviceConfiguration |
| userStatusOverview | deviceConfigurationUserOverview | 设备配置用户状态概述 继承自 deviceConfiguration |
| deviceSettingStateSummaries | settingStateDeviceSummary 集合 | 设备配置设置状态设备摘要 继承自 deviceConfiguration |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.windowsDeliveryOptimizationConfiguration",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"roleScopeTagIds": [
"String"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"String"
],
"name": "String",
"ruleType": "String"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "String",
"maxOSVersion": "String",
"name": "String",
"ruleType": "String"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "String",
"name": "String",
"ruleType": "String"
},
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"version": 1024,
"deliveryOptimizationMode": "String",
"restrictPeerSelectionBy": "String",
"groupIdSource": {
"@odata.type": "microsoft.graph.deliveryOptimizationGroupIdSource"
},
"bandwidthMode": {
"@odata.type": "microsoft.graph.deliveryOptimizationBandwidth"
},
"backgroundDownloadFromHttpDelayInSeconds": 1024,
"foregroundDownloadFromHttpDelayInSeconds": 1024,
"minimumRamAllowedToPeerInGigabytes": 1024,
"minimumDiskSizeAllowedToPeerInGigabytes": 1024,
"minimumFileSizeToCacheInMegabytes": 1024,
"minimumBatteryPercentageAllowedToUpload": 1024,
"modifyCacheLocation": "String",
"maximumCacheAgeInDays": 1024,
"maximumCacheSize": {
"@odata.type": "microsoft.graph.deliveryOptimizationMaxCacheSize"
},
"vpnPeerCaching": "String",
"cacheServerHostNames": [
"String"
],
"cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 1024,
"cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 1024
}