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)
DeviceManagementApps.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)
Nicht unterstützt
Anwendung
DeviceManagementApps.ReadWrite.All
HTTP-Anforderung
POST /deviceAppManagement/managedEBooks/{managedEBookId}/userStateSummary
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „userInstallStateSummary“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „userInstallStateSummary“ erstellen.
Eigenschaft
Typ
Beschreibung
id
String
Schlüssel der Entität
userName
String
Name des Benutzers
installedDeviceCount
Int32
Anzahl der installierten Geräte
failedDeviceCount
Int32
Anzahl der fehlgeschlagenen Geräte
notInstalledDeviceCount
Int32
Anzahl der nicht installierten Geräte
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created und ein Objekt des Typs userInstallStateSummary im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/managedEBooks/{managedEBookId}/userStateSummary
Content-type: application/json
Content-length: 189
{
"@odata.type": "#microsoft.graph.userInstallStateSummary",
"userName": "User Name value",
"installedDeviceCount": 4,
"failedDeviceCount": 1,
"notInstalledDeviceCount": 7
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new UserInstallStateSummary
{
OdataType = "#microsoft.graph.userInstallStateSummary",
UserName = "User Name value",
InstalledDeviceCount = 4,
FailedDeviceCount = 1,
NotInstalledDeviceCount = 7,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.ManagedEBooks["{managedEBook-id}"].UserStateSummary.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewUserInstallStateSummary()
userName := "User Name value"
requestBody.SetUserName(&userName)
installedDeviceCount := int32(4)
requestBody.SetInstalledDeviceCount(&installedDeviceCount)
failedDeviceCount := int32(1)
requestBody.SetFailedDeviceCount(&failedDeviceCount)
notInstalledDeviceCount := int32(7)
requestBody.SetNotInstalledDeviceCount(¬InstalledDeviceCount)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
userStateSummary, err := graphClient.DeviceAppManagement().ManagedEBooks().ByManagedEBookId("managedEBook-id").UserStateSummary().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
UserInstallStateSummary userInstallStateSummary = new UserInstallStateSummary();
userInstallStateSummary.setOdataType("#microsoft.graph.userInstallStateSummary");
userInstallStateSummary.setUserName("User Name value");
userInstallStateSummary.setInstalledDeviceCount(4);
userInstallStateSummary.setFailedDeviceCount(1);
userInstallStateSummary.setNotInstalledDeviceCount(7);
UserInstallStateSummary result = graphClient.deviceAppManagement().managedEBooks().byManagedEBookId("{managedEBook-id}").userStateSummary().post(userInstallStateSummary);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\UserInstallStateSummary;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new UserInstallStateSummary();
$requestBody->setOdataType('#microsoft.graph.userInstallStateSummary');
$requestBody->setUserName('User Name value');
$requestBody->setInstalledDeviceCount(4);
$requestBody->setFailedDeviceCount(1);
$requestBody->setNotInstalledDeviceCount(7);
$result = $graphServiceClient->deviceAppManagement()->managedEBooks()->byManagedEBookId('managedEBook-id')->userStateSummary()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.user_install_state_summary import UserInstallStateSummary
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = UserInstallStateSummary(
odata_type = "#microsoft.graph.userInstallStateSummary",
user_name = "User Name value",
installed_device_count = 4,
failed_device_count = 1,
not_installed_device_count = 7,
)
result = await graph_client.device_app_management.managed_e_books.by_managed_e_book_id('managedEBook-id').user_state_summary.post(request_body)
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.