Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão
Permissões menos privilegiadas
Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante)
Directory.AccessAsUser.All
Indisponível.
Delegado (conta pessoal da Microsoft)
Sem suporte.
Sem suporte.
Aplicativo
Device.ReadWrite.All
Directory.ReadWrite.All
Em cenários somente de aplicativo e para dispositivos não Windows, ou seja, em que a propriedade operatingSystem não Windowsé , o aplicativo pode atualizar apenas a propriedade extensionAttributes .
O usuário chamador também deve estar em uma das seguintes funções de Microsoft Entra: Intune Administrador. Um usuário chamado na função Administrador de Dispositivos na Nuvem só pode habilitar ou desabilitar dispositivos usando essa API e um usuário com a função administrador de Windows 365 só pode atualizar as propriedades básicas do dispositivo. Um administrador global tem privilégios de gerenciamento completos sobre o dispositivo.
Solicitação HTTP
Você pode abordar o dispositivo usando sua id ou deviceId.
No corpo da solicitação, forneça os valores para as propriedades device que devem ser atualizadas. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter o melhor desempenho, não inclua valores existentes que não foram alterados.
Propriedade
Tipo
Descrição
accountEnabled
Booliano
true se a conta estiver habilitada; caso contrário, false. Somente os chamadores nas funções administrador global e administrador de dispositivos na nuvem podem atualizar essa propriedade.
operatingSystem
String
O tipo de sistema operacional do dispositivo.
operatingSystemVersion
Cadeia de caracteres
A versão do sistema operacional do dispositivo.
displayName
String
O nome de exibição do dispositivo.
isCompliant
Booliano
truese o dispositivo estiver em conformidade com as políticas de MDM (mobile Gerenciamento de Dispositivos) ; caso contrário, false. Isso só pode ser atualizado por Intune para qualquer tipo de sistema operacional de dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows.
isManaged
Booliano
truese o dispositivo for gerenciado por um aplicativo MDM (Mobile Gerenciamento de Dispositivos) ; caso contrário, false. Isso só pode ser atualizado por Intune para qualquer tipo de sistema operacional de dispositivo ou por um aplicativo MDM aprovado para dispositivos do sistema operacional Windows.
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content.
Exemplos
Exemplo 1: atualizar a propriedade accountEnabled de um dispositivo
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Device
{
AccountEnabled = false,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Devices["{device-id}"].PatchAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Device device = new Device();
device.setAccountEnabled(false);
Device result = graphClient.devices().byDeviceId("{device-id}").patch(device);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Device;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new Device();
$requestBody->setAccountEnabled(false);
$result = $graphServiceClient->devices()->byDeviceId('device-id')->patch($requestBody)->wait();
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Device
{
AdditionalData = new Dictionary<string, object>
{
{
"extensionAttributes" , new
{
ExtensionAttribute1 = "BYOD-Device",
}
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Devices["{device-id}"].PatchAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc devices patch --device-id {device-id} --body '{\
"extensionAttributes": {\
"extensionAttribute1": "BYOD-Device"\
}\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Device device = new Device();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
extensionAttributes = new ();
extensionAttributes.setExtensionAttribute1("BYOD-Device");
additionalData.put("extensionAttributes", extensionAttributes);
device.setAdditionalData(additionalData);
Device result = graphClient.devices().byDeviceId("{device-id}").patch(device);
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.