androidDeviceOwnerEnrollmentProfile 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 androidDeviceOwnerEnrollmentProfile-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/androidDeviceOwnerEnrollmentProfiles

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 androidDeviceOwnerEnrollmentProfile an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von androidDeviceOwnerEnrollmentProfile erforderlich sind.

Eigenschaft	Typ	Beschreibung
accountId	String	Mandanten-GUID, zu der das Registrierungsprofil gehört.
id	String	Eindeutige GUID des Registrierungsprofils.
displayName	String	Anzeigename des Registrierungsprofils.
description	String	Beschreibung des Registrierungsprofils.
enrollmentMode	androidDeviceOwnerEnrollmentMode	Der Registrierungsmodus von Geräten, die dieses Registrierungsprofil verwenden. Mögliche Werte: corporateOwnedDedicatedDevice, corporateOwnedFullyManaged, corporateOwnedWorkProfile, corporateOwnedAOSPUserlessDevice, corporateOwnedAOSPUserAssociatedDevice.
enrollmentTokenType	androidDeviceOwnerEnrollmentTokenType	Der Registrierungstokentyp für ein Registrierungsprofil. Mögliche Werte sind: default, corporateOwnedDedicatedDeviceWithAzureADSharedMode und deviceStaging.
createdDateTime	DateTimeOffset	Datum und Uhrzeit der Erstellung des Registrierungsprofils.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung des Registrierungsprofils.
tokenValue	String	Wert des zuletzt für das Registrierungsprofil erstellten Tokens.
tokenCreationDateTime	DateTimeOffset	Datum, zu dem das zuletzt erstellte Token erstellt wurde.
tokenExpirationDateTime	DateTimeOffset	Datum und Uhrzeit des Ablaufs des zuletzt erstellten Tokens.
enrolledDeviceCount	Int32	Gesamtzahl der mit dem Registrierungsprofil registrierten Android-Geräte.
enrollmentTokenUsageCount	Int32	Gesamtanzahl der AOSP-Geräte, die mit dem aktuellen Token registriert wurden. Gültige Werte 0 bis 20000
qrCodeContent	String	Zeichenfolge, die zur Generierung eines QR-Codes für das Token verwendet wird.
qrCodeImage	mimeContent	Zeichenfolge, die zur Generierung eines QR-Codes für das Token verwendet wird.
roleScopeTagIds	String collection	Liste der Bereichstags für diese entitätsbezogene instance.
configureWifi	Boolesch	Boolescher Wert, der angibt, dass das Wi-Fi Netzwerk während der Gerätebereitstellung konfiguriert werden soll. Bei Festlegung auf TRUE verwendet die Gerätebereitstellung Wi-Fi zugehörigen Eigenschaften, um automatisch eine Verbindung mit Wi-Fi Netzwerken herzustellen. Bei Festlegung auf FALSE oder undefiniert werden andere Wi-Fi verwandte Eigenschaften ignoriert. Der Standardwert ist TRUE. Wird standardmäßig zurückgegeben.
wifiSsid	String	Zeichenfolge, die die SSID der WLAN-Anmeldung enthält
wifiPassword	String	Zeichenfolge, die das WLAN-Anmeldekennwort enthält
wifiSecurityType	aospWifiSecurityType	Zeichenfolge, die den WLAN-Sicherheitstyp enthält. Mögliche Werte sind: none, wpa und wep.
wifiHidden	Boolesch	Boolescher Wert, der angibt, ob ausgeblendete WLAN-Netzwerke aktiviert sind
isTeamsDeviceProfile	Boolesch	Boolescher Wert, der angibt, ob es sich bei diesem Profil um ein Android AOSP for Teams-Geräteprofil handelt.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und ein androidDeviceOwnerEnrollmentProfile-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles
Content-type: application/json
Content-length: 981

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
  "accountId": "Account Id value",
  "displayName": "Display Name value",
  "description": "Description value",
  "enrollmentMode": "corporateOwnedFullyManaged",
  "enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
  "tokenValue": "Token Value value",
  "tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "enrolledDeviceCount": 3,
  "enrollmentTokenUsageCount": 9,
  "qrCodeContent": "Qr Code Content value",
  "qrCodeImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "configureWifi": true,
  "wifiSsid": "Wifi Ssid value",
  "wifiPassword": "Wifi Password value",
  "wifiSecurityType": "wpa",
  "wifiHidden": true,
  "isTeamsDeviceProfile": true
}

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: 1153

{
  "@odata.type": "#microsoft.graph.androidDeviceOwnerEnrollmentProfile",
  "accountId": "Account Id value",
  "id": "a8d0245e-245e-a8d0-5e24-d0a85e24d0a8",
  "displayName": "Display Name value",
  "description": "Description value",
  "enrollmentMode": "corporateOwnedFullyManaged",
  "enrollmentTokenType": "corporateOwnedDedicatedDeviceWithAzureADSharedMode",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "tokenValue": "Token Value value",
  "tokenCreationDateTime": "2017-01-01T00:01:38.5314127-08:00",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "enrolledDeviceCount": 3,
  "enrollmentTokenUsageCount": 9,
  "qrCodeContent": "Qr Code Content value",
  "qrCodeImage": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "configureWifi": true,
  "wifiSsid": "Wifi Ssid value",
  "wifiPassword": "Wifi Password value",
  "wifiSecurityType": "wpa",
  "wifiHidden": true,
  "isTeamsDeviceProfile": true
}