windowsDeliveryOptimizationConfiguration aktualisieren
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren Sie die Eigenschaften eines windowsDeliveryOptimizationConfiguration-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementConfiguration.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das objekt windowsDeliveryOptimizationConfiguration an .
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von windowsDeliveryOptimizationConfiguration erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Schlüssel der Entität Geerbt von deviceConfiguration. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration. |
| roleScopeTagIds | String collection | Liste der Bereichstags für diese entitätsbezogene instance. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolesch | Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Die Zuweisung zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert false ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies tritt bei legacy-Richtlinien auf, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal aufgelöst werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die Anwendbarkeit der Betriebssystemedition für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die Anwendbarkeitsregel der Betriebssystemversion für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Die Anwendbarkeitsregel für den Gerätemodus für diese Richtlinie. Geerbt von deviceConfiguration. |
| createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration. |
| description | String | Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| displayName | String | Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration. |
| Version | Int32 | Version der Gerätekonfiguration. Geerbt von deviceConfiguration. |
| deliveryOptimizationMode | windowsDeliveryOptimizationMode | Gibt die Downloadmethode an, mit der die Übermittlungsoptimierung den Verbrauch der Netzwerkbandbreite für große Inhaltsverteilungsszenarien verwalten kann. Mögliche Werte: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode. |
| restrictPeerSelectionBy | deliveryOptimizationRestrictPeerSelectionByOptions | Gibt an, dass die Peerauswahl über die ausgewählte Option eingeschränkt werden soll. |
Option 1 (Subnetzmaske) gilt nur für die Übermittlungsoptimierungsmodi Downloadmodus LAN (1) und Gruppe (2). Mögliche Werte sind: notConfigured und subnetMask. |
||
| groupIdSource | deliveryOptimizationGroupIdSource | Gibt an, dass die Peerauswahl auf eine specfic-Quelle beschränkt werden soll. |
| Die in dieser Richtlinie festgelegten Optionen gelten nur für den Downloadmodus Gruppe (2) im Übermittlungsoptimierungsmodus. Wenn Gruppe (2) nicht als Downloadmodus festgelegt ist, wird diese Richtlinie ignoriert. Für Option 3 – DHCP-Options-ID fragt der Client die DHCP-Options-ID 234 ab und verwendet den zurückgegebenen GUID-Wert als Gruppen-ID. | ||
| bandwidthMode | deliveryOptimizationBandwidth | Gibt die Nutzung der Vordergrund- und Hintergrundbandbreite mithilfe von Prozentsätzen, Absoluten oder Stunden an. |
| backgroundDownloadFromHttpDelayInSeconds | Int64 | Gibt die Anzahl der Sekunden an, um eine HTTP-Quelle in einem Hintergrunddownload zu verzögern, der Peer-to-Peer verwenden darf. Gültige Werte 0 bis 4294967295 |
| foregroundDownloadFromHttpDelayInSeconds | Int64 | Gibt die Anzahl der Sekunden an, um eine HTTP-Quelle in einem Vordergrunddownload zu verzögern, der Peer-to-Peer verwenden darf (0-86400). Gültige Werte 0 bis 86400 |
| Die Angabe von 0 legt die Übermittlungsoptimierung fest, um diese Einstellung mithilfe des Clouddiensts zu verwalten. Gültige Werte 0 bis 86400 | ||
| minimumRamAllowedToPeerInGigabytes | Int32 | Gibt die minimale RAM-Größe in GB an, um peer caching (1-100000) zu verwenden. Gültige Werte 1 bis 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | Gibt die mindeste Datenträgergröße in GB an, um peer caching (1-100000) zu verwenden. Gültige Werte 1 bis 100000 |
| Empfohlene Werte: 64 GB bis 256 GB. Gültige Werte 1 bis 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | Gibt die minimale Inhaltsdateigröße in MB an, die für die Verwendung des Peerzwischenspeicherns aktiviert ist (1-100000). Gültige Werte 1 bis 100000 |
| Empfohlene Werte: 1 MB bis 100.000 MB. Gültige Werte 1 bis 100000 | ||
| minimumBatteryPercentageAllowedToUpload | Int32 | Gibt den Mindestakkuprozentsatz an, mit dem das Gerät Daten hochladen kann (0-100). Gültige Werte: 0 bis 100. |
| Der Standardwert ist 0. Der Wert 0 (null) bedeutet "nicht beschränkt", und der Standardwert des Clouddiensts wird verwendet. Gültige Werte: 0 bis 100. | ||
| modifyCacheLocation | String | Gibt das Laufwerk an, das die Übermittlungsoptimierung für den Cache verwenden soll. |
| maximumCacheAgeInDays | Int32 | Gibt die maximale Zeit in Tagen an, die jede Datei nach dem erfolgreichen Herunterladen im Cache der Übermittlungsoptimierung gespeichert wird (0-3650). Gültige Werte 0 bis 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | Gibt die maximale Cachegröße für die Übermittlungsoptimierung entweder als Prozentsatz oder in GB an. |
| vpnPeerCaching | Ermöglichen | Gibt an, ob das Gerät am Peercache teilnehmen darf, während es über vpn mit dem Domänennetzwerk verbunden ist. Mögliche Werte sind: notConfigured, enabled und disabled. |
| cacheServerHostNames | String collection | Gibt Die Hostnamen von Cacheservern an. |
| cacheServerForegroundDownloadFallbackToHttpDelayInSeconds | Int32 | Gibt die Anzahl von Sekunden an, um ein Fallback von Cacheservern auf eine HTTP-Quelle für einen Vordergrunddownload zu verzögern. Gültige Werte 0 bis 2592000. |
| cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds | Int32 | Gibt die Anzahl von Sekunden an, um ein Fallback von Cacheservern auf eine HTTP-Quelle für einen Hintergrunddownload zu verzögern. Gültige Werte 0 bis 2592000. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes windowsDeliveryOptimizationConfiguration-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 2039
{
"@odata.type": "#microsoft.graph.windowsDeliveryOptimizationConfiguration",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"restrictPeerSelectionBy": "subnetMask",
"groupIdSource": {
"@odata.type": "microsoft.graph.deliveryOptimizationGroupIdSource"
},
"bandwidthMode": {
"@odata.type": "microsoft.graph.deliveryOptimizationBandwidth"
},
"backgroundDownloadFromHttpDelayInSeconds": 8,
"foregroundDownloadFromHttpDelayInSeconds": 8,
"minimumRamAllowedToPeerInGigabytes": 2,
"minimumDiskSizeAllowedToPeerInGigabytes": 7,
"minimumFileSizeToCacheInMegabytes": 1,
"minimumBatteryPercentageAllowedToUpload": 7,
"modifyCacheLocation": "Modify Cache Location value",
"maximumCacheAgeInDays": 5,
"maximumCacheSize": {
"@odata.type": "microsoft.graph.deliveryOptimizationMaxCacheSize"
},
"vpnPeerCaching": "enabled",
"cacheServerHostNames": [
"Cache Server Host Names value"
],
"cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 9,
"cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 9
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2211
{
"@odata.type": "#microsoft.graph.windowsDeliveryOptimizationConfiguration",
"id": "5954ee9b-ee9b-5954-9bee-54599bee5459",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"deliveryOptimizationMode": "httpOnly",
"restrictPeerSelectionBy": "subnetMask",
"groupIdSource": {
"@odata.type": "microsoft.graph.deliveryOptimizationGroupIdSource"
},
"bandwidthMode": {
"@odata.type": "microsoft.graph.deliveryOptimizationBandwidth"
},
"backgroundDownloadFromHttpDelayInSeconds": 8,
"foregroundDownloadFromHttpDelayInSeconds": 8,
"minimumRamAllowedToPeerInGigabytes": 2,
"minimumDiskSizeAllowedToPeerInGigabytes": 7,
"minimumFileSizeToCacheInMegabytes": 1,
"minimumBatteryPercentageAllowedToUpload": 7,
"modifyCacheLocation": "Modify Cache Location value",
"maximumCacheAgeInDays": 5,
"maximumCacheSize": {
"@odata.type": "microsoft.graph.deliveryOptimizationMaxCacheSize"
},
"vpnPeerCaching": "enabled",
"cacheServerHostNames": [
"Cache Server Host Names value"
],
"cacheServerForegroundDownloadFallbackToHttpDelayInSeconds": 9,
"cacheServerBackgroundDownloadFallbackToHttpDelayInSeconds": 9
}