windowsDeliveryOptimizationConfiguration erstellen

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.

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
Anwendung	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 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 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
}