Erstellen von depOnboardingSetting
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 depOnboardingSetting-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | 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) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/depOnboardingSettings
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das depOnboardingSetting-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von depOnboardingSetting erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | UUID für das Objekt |
appleIdentifier | String | Die Apple-ID, die zum Abrufen des aktuellen Tokens verwendet wird. |
tokenExpirationDateTime | DateTimeOffset | Wann das Token abläuft. |
lastModifiedDateTime | DateTimeOffset | Zeitpunkt des Onboardings des Diensts. |
lastSuccessfulSyncDateTime | DateTimeOffset | Zeitpunkt der letzten Synchronisierung des Diensts mit Intune |
lastSyncTriggeredDateTime | DateTimeOffset | Wenn Intune zuletzt eine Synchronisierung angefordert hat. |
shareTokenWithSchoolDataSyncService | Boolesch | Gibt an, ob die Freigabe des Dep-Tokens mit dem School Data Sync-Dienst aktiviert ist. |
lastSyncErrorCode | Int32 | Fehlercode, der von Apple während der letzten Dep-Synchronisierung gemeldet wurde. |
Tokentype | depTokenType | Ruft den Dep-Tokentyp ab oder legt diese fest. Mögliche Werte sind: none , dep und appleSchoolManager . |
tokenName | String | Anzeigename für Dep-Token |
syncedDeviceCount | Int32 | Ruft die Anzahl synchronisierter Geräte ab. |
dataSharingConsentGranted | Boolesch | Erteilte Einwilligung für die Datenfreigabe mit Apple Dep Service |
roleScopeTagIds | String-Sammlung | Liste der Bereichstags für diese entitätsbezogene instance. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created
Antwortcode und ein depOnboardingSetting-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings
Content-type: application/json
Content-length: 576
{
"@odata.type": "#microsoft.graph.depOnboardingSetting",
"appleIdentifier": "Apple Identifier value",
"tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
"lastSuccessfulSyncDateTime": "2017-01-01T00:03:28.120883-08:00",
"lastSyncTriggeredDateTime": "2017-01-01T00:00:02.0916369-08:00",
"shareTokenWithSchoolDataSyncService": true,
"lastSyncErrorCode": 1,
"tokenType": "dep",
"tokenName": "Token Name value",
"syncedDeviceCount": 1,
"dataSharingConsentGranted": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
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: 689
{
"@odata.type": "#microsoft.graph.depOnboardingSetting",
"id": "40342229-2229-4034-2922-344029223440",
"appleIdentifier": "Apple Identifier value",
"tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"lastSuccessfulSyncDateTime": "2017-01-01T00:03:28.120883-08:00",
"lastSyncTriggeredDateTime": "2017-01-01T00:00:02.0916369-08:00",
"shareTokenWithSchoolDataSyncService": true,
"lastSyncErrorCode": 1,
"tokenType": "dep",
"tokenName": "Token Name value",
"syncedDeviceCount": 1,
"dataSharingConsentGranted": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für