Criar windowsAutopilotDeviceIdentity

Namespace: microsoft.graph

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
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementServiceConfig.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/windowsAutopilotDeviceIdentities

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.
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 valores possíveis são: unknown, enrolled, pendingReset, failed, notContacted.
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
managedDeviceId	Cadeia de caracteres	ID do dispositivo gerenciado
displayName	Cadeia de caracteres	Nome de exibição

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.

HTTP

POST https://graph.microsoft.com/v1.0/deviceManagement/windowsAutopilotDeviceIdentities
Content-type: application/json
Content-length: 814

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "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",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WindowsAutopilotDeviceIdentity
{
	OdataType = "#microsoft.graph.windowsAutopilotDeviceIdentity",
	GroupTag = "Group Tag value",
	PurchaseOrderIdentifier = "Purchase Order Identifier value",
	SerialNumber = "Serial Number value",
	ProductKey = "Product Key value",
	Manufacturer = "Manufacturer value",
	Model = "Model value",
	EnrollmentState = EnrollmentState.Enrolled,
	LastContactedDateTime = DateTimeOffset.Parse("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",
	ManagedDeviceId = "Managed Device Id value",
	DisplayName = "Display Name value",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.WindowsAutopilotDeviceIdentities.PostAsync(requestBody);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

CLI

mgc device-management windows-autopilot-device-identities create --body '{\
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",\
  "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",\
  "managedDeviceId": "Managed Device Id value",\
  "displayName": "Display Name value"\
}\
'

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWindowsAutopilotDeviceIdentity()
groupTag := "Group Tag value"
requestBody.SetGroupTag(&groupTag) 
purchaseOrderIdentifier := "Purchase Order Identifier value"
requestBody.SetPurchaseOrderIdentifier(&purchaseOrderIdentifier) 
serialNumber := "Serial Number value"
requestBody.SetSerialNumber(&serialNumber) 
productKey := "Product Key value"
requestBody.SetProductKey(&productKey) 
manufacturer := "Manufacturer value"
requestBody.SetManufacturer(&manufacturer) 
model := "Model value"
requestBody.SetModel(&model) 
enrollmentState := graphmodels.ENROLLED_ENROLLMENTSTATE 
requestBody.SetEnrollmentState(&enrollmentState) 
lastContactedDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:58:44.2908994-08:00")
requestBody.SetLastContactedDateTime(&lastContactedDateTime) 
addressableUserName := "Addressable User Name value"
requestBody.SetAddressableUserName(&addressableUserName) 
userPrincipalName := "User Principal Name value"
requestBody.SetUserPrincipalName(&userPrincipalName) 
resourceName := "Resource Name value"
requestBody.SetResourceName(&resourceName) 
skuNumber := "Sku Number value"
requestBody.SetSkuNumber(&skuNumber) 
systemFamily := "System Family value"
requestBody.SetSystemFamily(&systemFamily) 
azureActiveDirectoryDeviceId := "Azure Active Directory Device Id value"
requestBody.SetAzureActiveDirectoryDeviceId(&azureActiveDirectoryDeviceId) 
managedDeviceId := "Managed Device Id value"
requestBody.SetManagedDeviceId(&managedDeviceId) 
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
windowsAutopilotDeviceIdentities, err := graphClient.DeviceManagement().WindowsAutopilotDeviceIdentities().Post(context.Background(), requestBody, nil)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

WindowsAutopilotDeviceIdentity windowsAutopilotDeviceIdentity = new WindowsAutopilotDeviceIdentity();
windowsAutopilotDeviceIdentity.setOdataType("#microsoft.graph.windowsAutopilotDeviceIdentity");
windowsAutopilotDeviceIdentity.setGroupTag("Group Tag value");
windowsAutopilotDeviceIdentity.setPurchaseOrderIdentifier("Purchase Order Identifier value");
windowsAutopilotDeviceIdentity.setSerialNumber("Serial Number value");
windowsAutopilotDeviceIdentity.setProductKey("Product Key value");
windowsAutopilotDeviceIdentity.setManufacturer("Manufacturer value");
windowsAutopilotDeviceIdentity.setModel("Model value");
windowsAutopilotDeviceIdentity.setEnrollmentState(EnrollmentState.Enrolled);
OffsetDateTime lastContactedDateTime = OffsetDateTime.parse("2016-12-31T23:58:44.2908994-08:00");
windowsAutopilotDeviceIdentity.setLastContactedDateTime(lastContactedDateTime);
windowsAutopilotDeviceIdentity.setAddressableUserName("Addressable User Name value");
windowsAutopilotDeviceIdentity.setUserPrincipalName("User Principal Name value");
windowsAutopilotDeviceIdentity.setResourceName("Resource Name value");
windowsAutopilotDeviceIdentity.setSkuNumber("Sku Number value");
windowsAutopilotDeviceIdentity.setSystemFamily("System Family value");
windowsAutopilotDeviceIdentity.setAzureActiveDirectoryDeviceId("Azure Active Directory Device Id value");
windowsAutopilotDeviceIdentity.setManagedDeviceId("Managed Device Id value");
windowsAutopilotDeviceIdentity.setDisplayName("Display Name value");
WindowsAutopilotDeviceIdentity result = graphClient.deviceManagement().windowsAutopilotDeviceIdentities().post(windowsAutopilotDeviceIdentity);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const windowsAutopilotDeviceIdentity = {
  '@odata.type': '#microsoft.graph.windowsAutopilotDeviceIdentity',
  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',
  managedDeviceId: 'Managed Device Id value',
  displayName: 'Display Name value'
};

await client.api('/deviceManagement/windowsAutopilotDeviceIdentities')
	.post(windowsAutopilotDeviceIdentity);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsAutopilotDeviceIdentity;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new WindowsAutopilotDeviceIdentity();
$requestBody->setOdataType('#microsoft.graph.windowsAutopilotDeviceIdentity');
$requestBody->setGroupTag('Group Tag value');
$requestBody->setPurchaseOrderIdentifier('Purchase Order Identifier value');
$requestBody->setSerialNumber('Serial Number value');
$requestBody->setProductKey('Product Key value');
$requestBody->setManufacturer('Manufacturer value');
$requestBody->setModel('Model value');
$requestBody->setEnrollmentState(new EnrollmentState('enrolled'));
$requestBody->setLastContactedDateTime(new \DateTime('2016-12-31T23:58:44.2908994-08:00'));
$requestBody->setAddressableUserName('Addressable User Name value');
$requestBody->setUserPrincipalName('User Principal Name value');
$requestBody->setResourceName('Resource Name value');
$requestBody->setSkuNumber('Sku Number value');
$requestBody->setSystemFamily('System Family value');
$requestBody->setAzureActiveDirectoryDeviceId('Azure Active Directory Device Id value');
$requestBody->setManagedDeviceId('Managed Device Id value');
$requestBody->setDisplayName('Display Name value');

$result = $graphServiceClient->deviceManagement()->windowsAutopilotDeviceIdentities()->post($requestBody)->wait();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PowerShell

Import-Module Microsoft.Graph.DeviceManagement.Enrollment

$params = @{
	"@odata.type" = "#microsoft.graph.windowsAutopilotDeviceIdentity"
	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 = [System.DateTime]::Parse("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"
	managedDeviceId = "Managed Device Id value"
	displayName = "Display Name value"
}

New-MgDeviceManagementWindowsAutopilotDeviceIdentity -BodyParameter $params

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

from msgraph import GraphServiceClient
from msgraph.generated.models.windows_autopilot_device_identity import WindowsAutopilotDeviceIdentity

graph_client = GraphServiceClient(credentials, scopes)

request_body = WindowsAutopilotDeviceIdentity(
	odata_type = "#microsoft.graph.windowsAutopilotDeviceIdentity",
	group_tag = "Group Tag value",
	purchase_order_identifier = "Purchase Order Identifier value",
	serial_number = "Serial Number value",
	product_key = "Product Key value",
	manufacturer = "Manufacturer value",
	model = "Model value",
	enrollment_state = EnrollmentState.Enrolled,
	last_contacted_date_time = "2016-12-31T23:58:44.2908994-08:00",
	addressable_user_name = "Addressable User Name value",
	user_principal_name = "User Principal Name value",
	resource_name = "Resource Name value",
	sku_number = "Sku Number value",
	system_family = "System Family value",
	azure_active_directory_device_id = "Azure Active Directory Device Id value",
	managed_device_id = "Managed Device Id value",
	display_name = "Display Name value",
)

result = await graph_client.device_management.windows_autopilot_device_identities.post(request_body)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

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: 863

{
  "@odata.type": "#microsoft.graph.windowsAutopilotDeviceIdentity",
  "id": "fac6f0b1-f0b1-fac6-b1f0-c6fab1f0c6fa",
  "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",
  "managedDeviceId": "Managed Device Id value",
  "displayName": "Display Name value"
}