Gerät aktualisieren

Artikel
07/18/2022
4 Minuten Lesedauer

Namespace: microsoft.graph

Mit dieser API können Sie die Eigenschaften eines registrierten Geräts aktualisieren.

Nur bestimmte Eigenschaften eines Geräts können über genehmigte Geräteverwaltungs-App (Mobile Device Management, MDM) aktualisiert werden.

Wichtig

Diese API hat ein bekanntes Problem. Eine App mit Anwendungsberechtigungen kann nur die extensionAttributes-Eigenschaft für Linux-basierte Geräte aktualisieren, d. h., die eigenschaft "operationSystem " ist linux.

Berechtigungen

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.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Device.ReadWrite.All, Directory.ReadWrite.All

Der aufrufende Benutzer muss sich auch in einer der folgenden Azure AD-Rollen befinden: Globaler Administrator*, Intune Administrator*. Ein aufrufende Benutzer in der Rolle "Cloudgeräteadministrator" kann Geräte nur mithilfe dieser API aktivieren oder deaktivieren, und ein Benutzer mit der Rolle Windows 365 Administrator kann nur grundlegende Geräteeigenschaften aktualisieren.

HTTP-Anforderung

Die {id} in der Anforderung ist der Wert der ID-Eigenschaft des Geräts, nicht die deviceId-Eigenschaft .

PATCH /devices/{id}

Anforderungsheader

Name	Typ	Beschreibung
Authorization	string	Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext die Werte für die Eigenschaften des device-Objekts an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.

Eigenschaft	Typ	Beschreibung
accountEnabled	Boolesch	`true`, wenn das Konto aktiviert ist; andernfalls `false`. Nur Aufrufer in den Rollen "Globaler Administrator" und " Cloudgeräteadministrator " können diese Eigenschaft aktualisieren.
operatingSystem	String	Der Typ des Betriebssystems auf dem Gerät.
operatingSystemVersion	Zeichenfolge	Die Version des Betriebssystems auf dem Gerät.
displayName	String	Der Anzeigename für das Gerät.
isCompliant	Boolean	`true`wenn das Gerät den Richtlinien von Mobile Geräteverwaltung (MDM) entspricht; `false`andernfalls . Dies kann nur von Intune für jeden Gerätebetriebssystemtyp oder von einer genehmigten MDM-App für Windows-Betriebssystemgeräte aktualisiert werden.
isManaged	Boolean	`true`wenn das Gerät von einer Mobile Geräteverwaltung (MDM)-App verwaltet wird; `false`andernfalls . Dies kann nur von Intune für jeden Gerätebetriebssystemtyp oder von einer genehmigten MDM-App für Windows-Betriebssystemgeräte aktualisiert werden.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Aktualisieren der accountEnabled-Eigenschaft eines Geräts

Anforderung

PATCH https://graph.microsoft.com/v1.0/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
  "accountEnabled": false
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var device = new Device
{
    AccountEnabled = false
};

await graphClient.Devices["{device-id}"]
    .Request()
    .UpdateAsync(device);


const options = {
    authProvider,
};

const client = Client.init(options);

const device = {
  accountEnabled: false
};

await client.api('/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac')
    .update(device);


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/devices/{id}"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphDevice *device = [[MSGraphDevice alloc] init];
[device setAccountEnabled: false];

NSError *error;
NSData *deviceData = [device getSerializedDataWithError:&error];
[urlRequest setHTTPBody:deviceData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

Device device = new Device();
device.accountEnabled = false;

graphClient.devices("7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac")
    .buildRequest()
    .patch(device);


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewDevice()
accountEnabled := false
requestBody.SetAccountEnabled(&accountEnabled)
deviceId := "device-id"
graphClient.DevicesById(&deviceId).Patch(requestBody)


Import-Module Microsoft.Graph.Identity.DirectoryManagement

$params = @{
    AccountEnabled = $false
}

Update-MgDevice -DeviceId $deviceId -BodyParameter $params

Antwort

HTTP/1.1 204 No Content

Beispiel 2: Schreiben von extensionAttributes auf einem Gerät

Anforderung

PATCH https://graph.microsoft.com/v1.0/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
    "extensionAttributes": {
        "extensionAttribute1": "BYOD-Device"
    }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var device = new Device
{
    AdditionalData = new Dictionary<string, object>()
    {
        {"extensionAttributes", "{\"extensionAttribute1\":\"BYOD-Device\"}"}
    }
};

await graphClient.Devices["{device-id}"]
    .Request()
    .UpdateAsync(device);


const options = {
    authProvider,
};

const client = Client.init(options);

const device = {
    extensionAttributes: {
        extensionAttribute1: 'BYOD-Device'
    }
};

await client.api('/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac')
    .update(device);


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewDevice()
requestBody.SetAdditionalData(map[string]interface{}{
}
deviceId := "device-id"
graphClient.DevicesById(&deviceId).Patch(requestBody)


Import-Module Microsoft.Graph.Identity.DirectoryManagement

$params = @{
}

Update-MgDevice -DeviceId $deviceId -BodyParameter $params

Antwort

HTTP/1.1 204 No Content

Gerät aktualisieren

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Aktualisieren der accountEnabled-Eigenschaft eines Geräts

Anforderung

Antwort

Beispiel 2: Schreiben von extensionAttributes auf einem Gerät

Anforderung

Antwort

Feedback