Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig: Microsoft unterstützt Intune /beta-APIs, sie unterliegen jedoch häufigeren Änderungen. Microsoft empfiehlt, wenn möglich Version v1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version v1.0 mithilfe der Versionsauswahl.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues windowsDeliveryOptimizationConfiguration-Objekt .
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 |
| Application | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations
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 windowsDeliveryOptimizationConfiguration-Objekt an.
Die folgende Tabelle zeigt die Eigenschaften, die beim Erstellen der 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 Entity instance. Geerbt von deviceConfiguration. |
| supportsScopeTags | Boolean | 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 falsch ist und Entitäten für bereichsbezogene Benutzer nicht sichtbar sind. Dieses Problem tritt bei Legacyrichtlinien auf, die in Silverlight erstellt wurden, und kann behoben werden, indem die Richtlinie gelöscht und im Azure-Portal neu erstellt wird. Diese Eigenschaft ist schreibgeschützt. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsEdition | deviceManagementApplicabilityRuleOsEdition | Die für diese Richtlinie geltende Betriebssystemedition. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleOsVersion | deviceManagementApplicabilityRuleOsVersion | Die für diese Richtlinie geltende Regel zur Versionsanwendbarkeit. Geerbt von deviceConfiguration. |
| deviceManagementApplicabilityRuleDeviceMode | deviceManagementApplicabilityRuleDeviceMode | Die Gerätemodus-Anwendbarkeitsregel 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 Netzwerkbandbreitenverbrauch für Szenarien mit großer Inhaltsverteilung verwalten kann. Mögliche Werte: userDefined, httpOnly, httpWithPeeringNat, httpWithPeeringPrivateGroup, httpWithInternetPeering, simpleDownload, bypassMode. |
| restrictPeerSelectionBy | deliveryOptimizationRestrictPeerSelectionByOptions | Gibt an, die Peer-Auswahl über die ausgewählte Option einzuschränken. |
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, die Peer-Auswahl auf eine bestimmte Quelle zu beschränken. |
| Die in dieser Richtlinie festgelegten Optionen gelten nur für den Downloadmodus der Gruppe (2) im Übermittlungsoptimierungsmodus. Wenn Gruppe (2) nicht als Downloadmodus festgelegt ist, wird diese Richtlinie ignoriert. Bei 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 in Prozentwerten, absoluten Werten 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 die eine HTTP-Quelle in einem Vordergrund-Download verzögert werden soll, der Peer-to-Peer verwenden darf (0-86400). Gültige Werte: 0 bis 86400 |
| Wenn Sie 0 angeben, 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 für die Verwendung von Peercaching an (1-100000). Gültige Werte: 1 bis 100000 |
| minimumDiskSizeAllowedToPeerInGigabytes | Int32 | Gibt die Mindestgröße des Datenträgers in GB für die Verwendung des Peercaching an (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 Mindestgröße für Inhaltsdateien in MB an, die für die Verwendung von Peercaching 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, damit das Gerät Daten hochladen kann (0-100). Gültige Werte: 0 bis 100. |
| Der Standardwert ist 0. Der Wert 0 (null) bedeutet "nicht begrenzt", und es wird der Standardwert für den Clouddienst verwendet. Gültige Werte: 0 bis 100. | ||
| modifyCacheLocation | Zeichenfolge | Gibt das Laufwerk an, das von der Übermittlungsoptimierung für den Cache verwendet werden soll. |
| maximumCacheAgeInDays | Int32 | Gibt die maximale Zeit in Tagen an, die jede Datei nach erfolgreichem Download im Übermittlungsoptimierungs-Cache gespeichert wird (0-3650). Gültige Werte: 0 bis 3650 |
| maximumCacheSize | deliveryOptimizationMaxCacheSize | Gibt die maximale Cachegröße für die Ü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 | String collection | 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 Download im Hintergrund zu verzögern. Gültige Werte 0 bis 2592000. |
Antwort
Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein windowsDeliveryOptimizationConfiguration-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations
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 201 Created
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
}