Gerät erstellen

Dient zum Erstellen und Registrieren eines neuen Geräts in der Organisation.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen: Directory.AccessAsUser.All, Device.ReadWrite.All

HTTP-Anforderung

POST /devices

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer . Required.
Content-type string application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des device-Objekts an.

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/v1.0/devices
Content-type: application/json

{
  "accountEnabled":false,
  "alternativeSecurityIds":
  [
    {
      "type":2,
      "key":"Y3YxN2E1MWFlYw=="
    }
  ],
  "deviceId":"4c299165-6e8f-4b45-a5ba-c5d250a707ff",
  "displayName":"Test device",
  "operatingSystem":"linux",
  "operatingSystemVersion":"1"
}

Geben Sie im Anforderungstext eine JSON-Darstellung des device-Objekts an.

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

{
  "accountEnabled":false,
  "alternativeSecurityIds":
  [
    {
      "type":2,
      "key":"Y3YxN2E1MWFlYw=="
    }
  ],
  "deviceId":"4c299165-6e8f-4b45-a5ba-c5d250a707ff",
  "displayName":"Test device",
  "id": "id-value",
  "operatingSystem":"linux",
  "operatingSystemVersion":"1"
}