Erstellen von windowsAutopilotDeviceIdentity
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Erstellen Sie ein neues windowsAutopilotDeviceIdentity-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
POST /deviceManagement/windowsAutopilotDeviceIdentities
POST /deviceManagement/windowsAutopilotDeviceIdentities/{windowsAutopilotDeviceIdentityId}/deploymentProfile/assignedDevices
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das windowsAutopilotDeviceIdentity-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von windowsAutopilotDeviceIdentity erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | GUID des Objekts |
deploymentProfileAssignmentStatus | windowsAutopilotProfileAssignmentStatus | Profilzuweisung status des Windows Autopilot-Geräts. Mögliche Werte: unknown , assignedInSync , assignedOutOfSync , assignedUnkownSyncState , notAssigned , pending , failed . |
deploymentProfileAssignmentDetailedStatus | windowsAutopilotProfileAssignmentDetailedStatus | Detaillierte Profilzuweisung status des Windows Autopilot-Geräts. Mögliche Werte: none , hardwareRequirementsNotMet , surfaceHubProfileNotSupported , holoLensProfileNotSupported , windowsPcProfileNotSupported , surfaceHub2SProfileNotSupported , unknownFutureValue . |
deploymentProfileAssignedDateTime | DateTimeOffset | Profilsatzzeit des Windows Autopilot-Geräts. |
groupTag | String | Gruppentag des Windows Autopilot-Geräts. |
purchaseOrderIdentifier | String | Bestell-ID des Windows Autopilot-Geräts. |
serialNumber | String | Seriennummer des Windows AutoPilot-Geräts |
productKey | String | Product Key des Windows AutoPilot-Geräts |
Hersteller | String | Oem-Hersteller des Windows Autopilot-Geräts. |
model | String | Modellname des Windows Autopilot-Geräts. |
enrollmentState | enrollmentState | Intune Registrierungsstatus des Windows Autopilot-Geräts. Mögliche Werte sind: unknown , enrolled , pendingReset , failed , notContacted und blocked . |
lastContactedDateTime | DateTimeOffset | Intune Datum der letzten Kontaktaufnahme auf dem Windows Autopilot-Gerät. |
addressableUserName | String | Adressierbarer Benutzername. |
userPrincipalName | String | Benutzerprinzipalname. |
resourceName | String | Ressourcenname. |
skuNumber | String | SKU-Nummer |
systemFamily | String | Systemfamilie |
azureActiveDirectoryDeviceId | String | AAD-Geräte-ID: veraltet |
azureAdDeviceId | String | AAD-Geräte-ID |
managedDeviceId | String | ID des verwalteten Geräts |
displayName | String | Anzeigename |
deviceAccountUpn | String | Surface Hub-Gerätekontoupn |
deviceAccountPassword | String | Kennwort des Surface Hub-Gerätekontos |
deviceFriendlyName | String | Anzeigename des Surface Hub-Geräts |
remediationState | windowsAutopilotDeviceRemediationState | Zustand der Gerätewartung. Mögliche Werte: unknown , noRemediationRequired , automaticRemediationRequired , manualRemediationRequired , unknownFutureValue . |
remediationStateLastModifiedDateTime | DateTimeOffset | RemediationState: Festgelegte Zeit des Autopilot-Geräts. |
userlessEnrollmentStatus | windowsAutopilotUserlessEnrollmentStatus | Registrierung status für benutzerlose Registrierungen. Mögliche Werte: unknown , allowed , blocked , unknownFutureValue |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created
Antwortcode und ein windowsAutopilotDeviceIdentity-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
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"
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
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"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für