windowsDeliveryOptimizationConfiguration aktualisieren
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Dient zum Aktualisieren der Eigenschaften eines windowsDeliveryOptimizationConfiguration-Objekts.
Voraussetzungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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 |
| Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "windowsDeliveryOptimizationConfiguration" an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs "windowsDeliveryOptimizationConfiguration"erstellen.
| 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 | Zeichenfolgenauflistung | Liste der Bereichstags für diese Entitätsinstanz. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolesch | Gibt an, ob die zugrunde liegende Gerätekonfiguration die Zuweisung von Bereichstags unterstützt. Das Zuweisen zur ScopeTags-Eigenschaft ist nicht zulässig, wenn dieser Wert "false" ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dies geschieht für Legacyrichtlinien, die in Silverlight erstellt wurden, und kann durch Löschen und Erneutes Erstellen der Richtlinie im Azure-Portal behoben werden. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die Anwendbarkeit der Betriebssystem-Edition für diese Richtlinie. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die Anwendbarkeitsregel für die 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 | Zeichenfolge | 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, die die Übermittlungsoptimierung verwenden kann, um den Netzwerkbandbreitenverbrauch für große Inhaltsverteilungsszenarien zu verwalten. 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 bestimmte Quelle beschränkt werden soll. |
| Die in dieser Richtlinie festgelegten Optionen gelten nur für den Downloadmodus "ÜbermittlungsoptimierungsmodusGruppe (2)". Wenn Gruppe (2) nicht als Downloadmodus festgelegt ist, wird diese Richtlinie ignoriert. Bei Option 3 – DHCP-Options-ID fordert der Client die DHCP-Options-ID 234 ab und verwendet den zurückgegebenen GUID-Wert als Gruppen-ID. | ||
| bandwidthMode | deliveryOptimizationBandwidth | Gibt die Vordergrund- und Hintergrundbandbreitennutzung mit 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 (0-86400) verwenden darf. Gültige Werte: 0 bis 86400 |
| Durch Angeben von 0 wird die Übermittlungsoptimierung festgelegt, 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 peercaching zu verwenden (1-100000). Gültige Werte: 1 bis 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | Gibt die minimale Datenträgergröße in GB an, um peercaching zu verwenden (1-100000). Gültige Werte: 1 bis 100000 |
| Empfohlene Werte: 64 GB bis 256 GB. Gültige Werte: 1 bis 100000 | ||
| minimumFileSizeToCacheInMegabytes | Int32 | Gibt die minimale Größe der Inhaltsdatei in MB an, die für die Verwendung des Peercachings 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 minimalen Akkuprozentsatz an, um dem Gerät das Hochladen von Daten zu ermöglichen (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, in der jede Datei im Übermittlungsoptimierungscache nach dem erfolgreichen Herunterladen gespeichert wird (0-3650). Gültige Werte: 0 bis 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | Gibt die maximale Cachegröße der Übermittlungsoptimierung als Prozentsatz oder in GB an. |
| vpnPeerCaching | Aktivierung | Gibt an, ob das Gerät am Peercaching teilnehmen darf, während es über VPN mit dem Domänennetzwerk verbunden ist. Mögliche Werte sind: notConfigured, enabled und disabled. |
| cacheServerHostNames | Zeichenfolgenauflistung | Gibt Hostnamen für Cacheserver an. |
| cacheServerForegroundDownloadFallbackToHttpDelayInSeconds | Int32 | Gibt die Anzahl der Sekunden an, um einen 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 der Sekunden an, um einen 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
}
Feedback
Feedback senden und anzeigen für