Criar windowsAutopilotDeviceIdentity

Namespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.

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

Crie um novo objeto windowsAutopilotDeviceIdentity .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

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

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/windowsAutopilotDeviceIdentities
POST /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile/assignedDevices

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON para o objeto windowsAutopilotDeviceIdentity.

A tabela a seguir mostra as propriedades necessárias ao criar a entidade windowsAutopilotDeviceId.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	O GUID do objeto.
deploymentProfileAssignmentStatus	windowsAutopilotProfileAssignmentStatus	Atribuição de perfil status do dispositivo windows autopilot. Os valores possíveis são: unknown, assignedInSync, assignedOutOfSync, assignedUnkownSyncState, notAssigned, pending, failed.
deploymentProfileAssignmentDetailedStatus	windowsAutopilotProfileAssignmentDetailedStatus	Atribuição de perfil detalhada status do dispositivo windows autopilot. Os valores possíveis são: none, hardwareRequirementsNotMet, surfaceHubProfileNotSupported, holoLensProfileNotSupported, windowsPcProfileNotSupported, surfaceHub2SProfileNotSupported, unknownFutureValue.
deploymentProfileAssignedDateTime	DateTimeOffset	Tempo de conjunto de perfil do dispositivo de piloto automático do Windows.
groupTag	Cadeia de caracteres	Marca de grupo do dispositivo de piloto automático do Windows.
purchaseOrderIdentifier	Cadeia de caracteres	Identificador de pedido de compra do dispositivo de piloto automático do Windows.
serialNumber	Cadeia de caracteres	Número de série do dispositivo do Windows AutoPilot.
productKey	Cadeia de caracteres	Chave do produto (Product Key) do dispositivo do Windows AutoPilot.
fabricante	Cadeia de caracteres	Fabricante Oem do dispositivo windows autopilot.
modelo	Cadeia de caracteres	Nome do modelo do dispositivo de piloto automático do Windows.
enrollmentState	enrollmentState	Intune estado de registro do dispositivo de piloto automático do Windows. Os possíveis valores são: unknown, enrolled, pendingReset, failed, notContacted, blocked.
lastContactedDateTime	DateTimeOffset	Intune Última Data Contatada do dispositivo de piloto automático do Windows.
addressableUserName	Cadeia de caracteres	Nome de usuário endereçável.
userPrincipalName	Cadeia de caracteres	Nome da entidade de usuário.
resourceName	Cadeia de caracteres	Nome do recurso.
skuNumber	Cadeia de caracteres	Número de SKU
systemFamily	Cadeia de caracteres	Família do Sistema
azureActiveDirectoryDeviceId	Cadeia de caracteres	ID do dispositivo AAD – a ser preterido
azureAdDeviceId	Cadeia de caracteres	ID do dispositivo AAD
managedDeviceId	Cadeia de caracteres	ID do dispositivo gerenciado
displayName	Cadeia de caracteres	Nome de exibição
deviceAccountUpn	Cadeia de caracteres	Upn da conta de dispositivo do Surface Hub
deviceAccountPassword	Cadeia de caracteres	Senha da conta de dispositivo do Surface Hub
deviceFriendlyName	Cadeia de caracteres	Nome amigável do dispositivo do Surface Hub
remediationState	windowsAutopilotDeviceRemediationState	Estado de correção do dispositivo. Os valores possíveis são: unknown, noRemediationRequired, automaticRemediationRequired, manualRemediationRequired, unknownFutureValue.
remediationStateLastModifiedDateTime	DateTimeOffset	RemediationState set time of Autopilot device.
userlessEnrollmentStatus	windowsAutopilotUserlessEnrollmentStatus	O registro status para registros sem usuário. Os valores possíveis são: unknown, allowed, blocked, unknownFutureValue.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto windowsAutopilotDeviceIdentity no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeviceIdentities
Content-type: application/json
Content-length: 1413

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1462

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "id": "fac6f0b1-f0b1-fac6-b1f0-c6fab1f0c6fa",
  "deploymentProfileAssignmentStatus": "assignedInSync",
  "deploymentProfileAssignmentDetailedStatus": "hardwareRequirementsNotMet",
  "deploymentProfileAssignedDateTime": "2016-12-31T23:58:26.2447023-08:00",
  "groupTag": "Group Tag value",
  "purchaseOrderIdentifier": "Purchase Order Identifier value",
  "serialNumber": "Serial Number value",
  "productKey": "Product Key value",
  "manufacturer": "Manufacturer value",
  "model": "Model value",
  "enrollmentState": "enrolled",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "addressableUserName": "Addressable User Name value",
  "userPrincipalName": "User Principal Name value",
  "resourceName": "Resource Name value",
  "skuNumber": "Sku Number value",
  "systemFamily": "System Family value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureAdDeviceId": "Azure Ad Device Id value",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value",
  "deviceAccountUpn": "Device Account Upn value",
  "deviceAccountPassword": "Device Account Password value",
  "deviceFriendlyName": "Device Friendly Name value",
  "remediationState": "noRemediationRequired",
  "remediationStateLastModifiedDateTime": "2017-01-01T00:00:10.730021-08:00",
  "userlessEnrollmentStatus": "allowed"
}