Gerät aktualisierenUpdate device

Namespace: microsoft.graphNamespace: microsoft.graph

Mit dieser API können Sie die Eigenschaften eines registrierten Geräts aktualisieren.Update the properties of a registered device.

Nur bestimmte Eigenschaften eines Geräts können über genehmigte Geräteverwaltungs-App (Mobile Device Management, MDM) aktualisiert werden.Only certain properties of a device can be updated through approved Mobile Device Managment (MDM) apps.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Directory.ReadWrite.All, Directory.AccessAsUser.AllDirectory.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported

HTTP-AnforderungHTTP request

PATCH /devices/{id}

Hinweis: Die „id“ in der Anforderung entspricht der „id“-Eigenschaft des Geräts, nicht der „deviceId“-Eigenschaft.Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die Eigenschaften des device-Objekts an, die aktualisiert werden sollen.In the request body, supply the values for the device properties that should be updated. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
accountEnabledaccountEnabled BooleanBoolean true, wenn das Konto aktiviert ist; andernfalls false.true if the account is enabled; otherwise, false.
operatingSystemoperatingSystem StringString Der Typ des Betriebssystems auf dem Gerät.The type of operating system on the device.
operatingSystemVersionoperatingSystemVersion ZeichenfolgeString Die Version des Betriebssystems auf dem Gerät.The version of the operating system on the device
displayNamedisplayName ZeichenfolgeString Der Anzeigename für das Gerät.The display name for the device.
isCompliantisCompliant BooleanBoolean true, wenn das Gerät den Richtlinien für mobile Geräteverwaltung ( Mobile Device Management, MDM) entspricht; andernfalls false.true if the device complies with Mobile Device Management (MDM) policies; otherwise, false. Dies kann nur von InTune für alle Gerätebetriebssystem-Typen oder durch eine genehmigte MDM-App für Windows OS-Geräte aktualisiert werden.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
isManagedisManaged BooleanBoolean true, wenn das Gerät durch die mobile Geräteverwaltungs-App verwaltet wird; andernfalls false.true if the device is managed by a Mobile Device Management (MDM) app; otherwise, false. Dies kann nur von InTune für alle Gerätebetriebssystem-Typen oder durch eine genehmigte MDM-App für Windows OS-Geräte aktualisiert werden.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.If successful, this method returns a 204 No Content response code.

BeispielExample

AnforderungRequest
PATCH https://graph.microsoft.com/v1.0/devices/{id}
Content-type: application/json
Content-length: 31

{
  "accountEnabled": false
}
AntwortResponse
HTTP/1.1 204 No Content