Atualizar deviceManagement

Artigo
09/13/2021
3 minutos para o fim da leitura

Namespace: microsoft.graph

Importante: APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualizar as propriedades de um objeto deviceManagement.

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Observe que a permissão varia de acordo com o fluxo de trabalho.

Tipo de permissão (por fluxo de trabalho)	Permissões (de privilégios máximos a mínimos)
Delegado (conta corporativa ou de estudante)
Android for Work	DeviceManagementConfiguration.ReadWrite.All
Auditoria	DeviceManagementApps.ReadWrite.All
Termos da empresa	DeviceManagementServiceConfig.ReadWrite.All
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Intenção do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Gerenciamento de dispositivo	DeviceManagementManagedDevices.ReadWrite.All
SIM Eletrônico	DeviceManagementConfiguration.ReadWrite.All
Inscrição	DeviceManagementServiceConfig.ReadWrite.All
Esgrima	DeviceManagementConfiguration.ReadWrite.All
Notificação	DeviceManagementServiceConfig.ReadWrite.All
Odj	DeviceManagementServiceConfig.ReadWrite.All
Integração	DeviceManagementServiceConfig.ReadWrite.All
Conjunto de Políticas	DeviceManagementServiceConfig.ReadWrite.All
Controle de Acesso Baseado em Função (RBAC)	DeviceManagementRBAC.ReadWrite.All
Acesso remoto	DeviceManagementConfiguration.Read.All
Assistência remota	DeviceManagementServiceConfig.ReadWrite.All
Atualização de Software	DeviceManagementServiceConfig.ReadWrite.All
Gerenciamento de despesas de telecomunicações	DeviceManagementServiceConfig.ReadWrite.All
Troublehooting	DeviceManagementManagedDevices.ReadWrite.All
Proteção de Informações do Windows	DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo
Android for Work	DeviceManagementConfiguration.ReadWrite.All
Auditoria	DeviceManagementApps.ReadWrite.All
Termos da empresa	DeviceManagementServiceConfig.ReadWrite.All
Configuração do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Intenção do dispositivo	DeviceManagementConfiguration.ReadWrite.All
Gerenciamento de dispositivo	DeviceManagementManagedDevices.ReadWrite.All
SIM Eletrônico	DeviceManagementConfiguration.ReadWrite.All
Inscrição	DeviceManagementServiceConfig.ReadWrite.All
Esgrima	DeviceManagementConfiguration.ReadWrite.All
Notificação	DeviceManagementServiceConfig.ReadWrite.All
Odj	DeviceManagementServiceConfig.ReadWrite.All
Integração	DeviceManagementServiceConfig.ReadWrite.All
Conjunto de Políticas	DeviceManagementServiceConfig.ReadWrite.All
Controle de Acesso Baseado em Função (RBAC)	DeviceManagementRBAC.ReadWrite.All
Acesso remoto	DeviceManagementConfiguration.Read.All
Assistência remota	DeviceManagementServiceConfig.ReadWrite.All
Atualização de Software	DeviceManagementServiceConfig.ReadWrite.All
Gerenciamento de despesas de telecomunicações	DeviceManagementServiceConfig.ReadWrite.All
Troublehooting	DeviceManagementManagedDevices.ReadWrite.All
Proteção de Informações do Windows	DeviceManagementApps.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagement.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagement.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Identificador exclusivo do dispositivo.
Configuração do dispositivo
intuneAccountId	GUID	ID da conta do Intune para determinado locatário
legacyPcManangementEnabled	Boleano	A propriedade para habilitar o gerenciamento de computador herdado não-MDM gerenciado para essa conta. Essa propriedade é somente leitura.
maximumDepTokens	Int32	Número máximo de tokens DEP permitidos por locatário.
settings	deviceManagementSettings	Configurações de nível da conta.
Gerenciamento de dispositivo
accountMoveCompletionDateTime	DateTimeOffset	A data & hora em que os dados do locatário foram movidos entre as unidades de escala.
adminConsent	adminConsent	Informações de consentimento do administrador.
deviceProtectionOverview	deviceProtectionOverview	Visão geral da proteção do dispositivo.
managedDeviceCleanupSettings	managedDeviceCleanupSettings	Regra de limpeza de dispositivo
subscriptionState	deviceManagementSubscriptionState	Estado de assinatura de gerenciamento de dispositivo móvel do locatário. Os valores possíveis são: `pending`, `active`, `warning`, `disabled`, `deleted`, `blocked`, `lockedOut`.
assinaturas	deviceManagementSubscriptions	Assinatura do locatário. Os possíveis valores são: `none`, `intune`, `office365`, `intunePremium`, `intune_EDU`, `intune_SMB`.
windowsMalwareOverview	windowsMalwareOverview	Visão geral do malware para dispositivos windows.
Integração
intuneBrand	intuneBrand	intuneBrand contém dados que são usados na personalização da aparência dos aplicativos do Portal da Empresa, bem como do portal da Web de usuários finais.

O suporte à propriedade request body varia de acordo com o fluxo de trabalho.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK e um objeto deviceManagement atualizado no corpo da resposta.

Exemplo

Solicitação

Veja um exemplo de uma solicitação após o fluxo de trabalho de gerenciamento de dispositivos:

PATCH https://graph.microsoft.com/beta/deviceManagement
Content-type: application/json
Content-length: 751

{
  "subscriptionState": "active",
  "subscriptions": "intune",
  "adminConsent": {
    "@odata.type": "microsoft.graph.adminConsent",
    "shareAPNSData": "granted"
  },
  "deviceProtectionOverview": {
    "@odata.type": "microsoft.graph.deviceProtectionOverview",
    "totalReportedDeviceCount": 8,
    "inactiveThreatAgentDeviceCount": 14,
    "unknownStateThreatAgentDeviceCount": 2,
    "pendingSignatureUpdateDeviceCount": 1,
    "cleanDeviceCount": 0,
    "pendingFullScanDeviceCount": 10,
    "pendingRestartDeviceCount": 9,
    "pendingManualStepsDeviceCount": 13,
    "pendingOfflineScanDeviceCount": 13,
    "criticalFailuresDeviceCount": 11
  },
  "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
}

Resposta

Veja a seguir um exemplo da resposta.

Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. As propriedades retornadas variam de acordo com o fluxo de trabalho e o contexto.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 855

{
  "@odata.type": "#microsoft.graph.deviceManagement",
  "id": "0b283420-3420-0b28-2034-280b2034280b",
  "subscriptionState": "active",
  "subscriptions": "intune",
  "adminConsent": {
    "@odata.type": "microsoft.graph.adminConsent",
    "shareAPNSData": "granted"
  },
  "deviceProtectionOverview": {
    "@odata.type": "microsoft.graph.deviceProtectionOverview",
    "totalReportedDeviceCount": 8,
    "inactiveThreatAgentDeviceCount": 14,
    "unknownStateThreatAgentDeviceCount": 2,
    "pendingSignatureUpdateDeviceCount": 1,
    "cleanDeviceCount": 0,
    "pendingFullScanDeviceCount": 10,
    "pendingRestartDeviceCount": 9,
    "pendingManualStepsDeviceCount": 13,
    "pendingOfflineScanDeviceCount": 13,
    "criticalFailuresDeviceCount": 11
  },
  "accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
}

Atualizar deviceManagement

Pré-requisitos

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários