Espace de noms: microsoft.graph
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
Nettoyer le périphérique Windows
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global |
Gouvernement des États-Unis L4 |
Us Government L5 (DOD) |
Chine gérée par 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Autorisations
L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.
| Type d’autorisation |
Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins) |
| Déléguée (compte professionnel ou scolaire) |
DeviceManagementManagedDevices.PrivilegedOperations.All |
| Déléguée (compte Microsoft personnel) |
Non prise en charge. |
| Application |
DeviceManagementManagedDevices.PrivilegedOperations.All |
Requête HTTP
POST /deviceManagement/managedDevices/{managedDeviceId}/cleanWindowsDevice
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/cleanWindowsDevice
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices/{managedDeviceId}/cleanWindowsDevice
Corps de la demande
Dans le corps de la demande, fournissez une représentation JSON des paramètres.
Le tableau suivant indique les paramètres qui peuvent être utilisés avec cette action.
| Propriété |
Type |
Description |
| keepUserData |
Booléen |
Pas encore documenté |
Réponse
Si elle réussit, cette action renvoie un code de réponse 204 No Content.
Exemple
Demande
Voici un exemple de demande.
POST https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId}/cleanWindowsDevice
Content-type: application/json
Content-length: 28
{
"keepUserData": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.DeviceManagement.ManagedDevices.Item.CleanWindowsDevice;
var requestBody = new CleanWindowsDevicePostRequestBody
{
KeepUserData = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.DeviceManagement.ManagedDevices["{managedDevice-id}"].CleanWindowsDevice.PostAsync(requestBody);
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
// 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"
graphdevicemanagement "github.com/microsoftgraph/msgraph-sdk-go/devicemanagement"
//other-imports
)
requestBody := graphdevicemanagement.NewCleanWindowsDevicePostRequestBody()
keepUserData := true
requestBody.SetKeepUserData(&keepUserData)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.DeviceManagement().ManagedDevices().ByManagedDeviceId("managedDevice-id").CleanWindowsDevice().Post(context.Background(), requestBody, nil)
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.devicemanagement.manageddevices.item.cleanwindowsdevice.CleanWindowsDevicePostRequestBody cleanWindowsDevicePostRequestBody = new com.microsoft.graph.devicemanagement.manageddevices.item.cleanwindowsdevice.CleanWindowsDevicePostRequestBody();
cleanWindowsDevicePostRequestBody.setKeepUserData(true);
graphClient.deviceManagement().managedDevices().byManagedDeviceId("{managedDevice-id}").cleanWindowsDevice().post(cleanWindowsDevicePostRequestBody);
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\DeviceManagement\ManagedDevices\Item\CleanWindowsDevice\CleanWindowsDevicePostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new CleanWindowsDevicePostRequestBody();
$requestBody->setKeepUserData(true);
$graphServiceClient->deviceManagement()->managedDevices()->byManagedDeviceId('managedDevice-id')->cleanWindowsDevice()->post($requestBody)->wait();
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.devicemanagement.manageddevices.item.clean_windows_device.clean_windows_device_post_request_body import CleanWindowsDevicePostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CleanWindowsDevicePostRequestBody(
keep_user_data = True,
)
await graph_client.device_management.managed_devices.by_managed_device_id('managedDevice-id').clean_windows_device.post(request_body)
Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).
Réponse
Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 204 No Content