Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Importante: Microsoft admite las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versión.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Configuración de Optimización de distribución de Windows
Hereda de deviceConfiguration
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Enumerar windowsDeliveryOptimizationConfigurations | Colección WindowsDeliveryOptimizationConfiguration | Enumerar las propiedades y relaciones de los objetos windowsDeliveryOptimizationConfiguration . |
| Obtener windowsDeliveryOptimizationConfiguration | windowsDeliveryOptimizationConfiguration | Lee las propiedades y relaciones del objeto windowsDeliveryOptimizationConfiguration . |
| Crear windowsDeliveryOptimizationConfiguration | windowsDeliveryOptimizationConfiguration | Crea un nuevo objeto windowsDeliveryOptimizationConfiguration . |
| Eliminar windowsDeliveryOptimizationConfiguration | Ninguno | Elimina una configuración windowsDeliveryOptimizationConfiguration. |
| Update windowsDeliveryOptimizationConfiguration | windowsDeliveryOptimizationConfiguration | Actualiza las propiedades de un objeto windowsDeliveryOptimizationConfiguration . |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Heredado de deviceConfiguration |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora en la que se modificó el objeto por última vez. Heredado de deviceConfiguration |
| roleScopeTagIds | Colección string | Lista de etiquetas de ámbito para esta instancia de entidad. Heredado de deviceConfiguration |
| supportsScopeTags | Booleano | Indica si la configuración del dispositivo subyacente admite o no la asignación de etiquetas de ámbito. No se permite la asignación a la propiedad ScopeTags cuando este valor es falso y las entidades no serán visibles para los usuarios con ámbito. Esto ocurre con las directivas heredadas creadas en Silverlight y se puede resolver eliminando y volviendo a crear la directiva en Azure Portal. Esta propiedad es de sólo lectura. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Aplicabilidad de la edición del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Regla de aplicabilidad de la versión del sistema operativo para esta directiva. Heredado de deviceConfiguration |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Regla de aplicabilidad del modo de dispositivo para esta directiva. Heredado de deviceConfiguration |
| createdDateTime | DateTimeOffset | Fecha y hora en la que se creó el objeto. Heredado de deviceConfiguration |
| description | Cadena | Descripción proporcionada por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| displayName | Cadena | Nombre proporcionado por el administrador de la configuración del dispositivo. Heredado de deviceConfiguration |
| version | Int32 | Versión de la configuración del dispositivo. Heredado de deviceConfiguration |
| deliveryOptimizationMode | windowsDeliveryOptimizationMode | Especifica el método de descarga que la optimización de distribución puede usar para administrar el consumo de ancho de banda de red para escenarios de distribución de contenido grandes. Valores posibles: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode. |
| restrictPeerSelectionBy | deliveryOptimizationRestrictPeerSelectionByOptions | Especifica que se restrinja la selección de sistemas del mismo nivel mediante la opción seleccionada. |
La opción 1 (máscara de subred) solo se aplica a los modos de Optimización de distribución: Modo de descarga: LAN (1) y Grupo (2). Los valores posibles son notConfigured y subnetMask. |
||
| groupIdSource | deliveryOptimizationGroupIdSource | Especifica que se restrinja la selección del mismo nivel a un origen específico. |
| Las opciones establecidas en esta directiva solo se aplican al modo de Optimización de distribución Modo de descarga del grupo (2). Si el grupo (2) no está establecido como modo de descarga, se omitirá esta directiva. Para la opción 3: id. de opción DHCP, el cliente consultará el id. de opción DHCP 234 y usará el valor GUID devuelto como identificador de grupo. | ||
| bandwidthMode | deliveryOptimizationBandwidth | Especifica el uso del ancho de banda en primer plano y fondo mediante porcentajes, absolutos u horas. |
| backgroundDownloadFromHttpDelayInSeconds | Int64 | Especifica el número de segundos que se debe retrasar un origen HTTP en una descarga en segundo plano que puede usar peer-to-peer. Valores válidos de 0 a 4294967295 |
| foregroundDownloadFromHttpDelayInSeconds | Int64 | Especifica el número de segundos que se retrasará un origen HTTP en una descarga en primer plano que puede usar peer-to-peer (0-86400). Valores válidos de 0 a 86400 |
| La especificación 0 establece la Optimización de distribución para administrar esta configuración mediante el servicio en la nube. Valores válidos de 0 a 86400 | ||
| minimumRamAllowedToPeerInGigabytes | Int32 | Especifica el tamaño mínimo de RAM en GB para usar almacenamiento en caché de sistemas de mismo nivel (1-100000). Valores válidos del 1 al 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | Especifica el tamaño de disco mínimo en GB para usar el almacenamiento en caché de sistemas de mismo nivel (1-100000). Valores válidos del 1 al 100000 |
| Valores recomendados: de 64 GB a 256 GB. Valores válidos del 1 al 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | Especifica el tamaño mínimo del archivo de contenido en MB habilitado para usar almacenamiento en caché de sistemas de mismo nivel (1-100000). Valores válidos del 1 al 100000 |
| Valores recomendados: de 1 MB a 100 000 MB. Valores válidos del 1 al 100000 | ||
| minimumBatteryPercentageAllowedToUpload | Int32 | Especifica el porcentaje de batería mínimo para permitir que el dispositivo cargue datos (0-100). Valores válidos de 0 a 100. |
| El valor predeterminado es 0. El valor 0 (cero) significa "no limitado" y se usará el valor predeterminado del servicio en la nube. Valores válidos de 0 a 100. | ||
| modifyCacheLocation | Cadena | Especifica la unidad que la optimización de distribución debe usar para su caché. |
| maximumCacheAgeInDays | Int32 | Especifica el tiempo máximo en días que cada archivo se almacena en la memoria caché de optimización de distribución después de descargarse correctamente (0-3650). Valores válidos de 0 a 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | Especifica el tamaño máximo de caché que la Optimización de distribución puede ser en porcentaje o en GB. |
| vpnPeerCaching | un solo clic | Especifica si el dispositivo puede participar en el almacenamiento en caché de sistemas de mismo nivel mientras está conectado a través de VPN a la red del dominio. Los valores posibles son: notConfigured, enabled y disabled. |
| cacheServerHostNames | Colección string | Especifica los nombres de host de los servidores de caché. |
| cacheServerForegroundDownloadFallbackToHttpDelayInSeconds | Int32 | Especifica el número de segundos que se retrasan un retroceso de los servidores de caché a un origen HTTP para una descarga en primer plano. Valores válidos de 0 a 2592000. |
| cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds | Int32 | Especifica el número de segundos que se debe retrasar una reserva de los servidores de caché a un origen HTTP para una descarga en segundo plano. Valores válidos de 0 a 2592000. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| groupAssignments | Colección deviceConfigurationGroupAssignment | La lista de asignaciones de grupo para el perfil de configuración del dispositivo. Heredado de deviceConfiguration |
| assignments | Colección deviceConfigurationAssignment | La lista de tareas para el perfil de configuración del dispositivo. Heredado de deviceConfiguration |
| deviceStatuses | Colección deviceConfigurationDeviceStatus | Estado de instalación de configuración del dispositivo por dispositivo. Heredado de deviceConfiguration |
| userStatuses | Colección deviceConfigurationUserStatus | Estado de instalación de la configuración del dispositivo por usuario. Heredado de deviceConfiguration |
| deviceStatusOverview | deviceConfigurationDeviceOverview | Información general sobre el estado de dispositivos de la configuración de dispositivo. Heredado de deviceConfiguration |
| userStatusOverview | deviceConfigurationUserOverview | Información general sobre el estado de usuarios de la configuración de dispositivo. Heredado de deviceConfiguration |
| deviceSettingStateSummaries | Colección settingStateDeviceSummary | Resumen de dispositivo sobre el estado de configuración de la configuración de dispositivo. Heredado de deviceConfiguration |
Representación JSON
Aquí tiene una representación JSON del recurso.
{
"@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
}