Erstellen von activeDirectoryWindowsAutopilotDeploymentProfile
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 activeDirectoryWindowsAutopilotDeploymentProfile-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/windowsAutopilotDeploymentProfiles
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 activeDirectoryWindowsAutopilotDeploymentProfile-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von activeDirectoryWindowsAutopilotDeploymentProfile erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Von windowsAutopilotDeploymentProfile geerbter Profilschlüssel |
| displayName | String | Der Anzeigename des Bereitstellungsprofils. Die maximal zulässige Länge beträgt 200 Zeichen. Wird standardmäßig zurückgegeben. Unterstützt: $select, $top, $skip, $orderby. $Search und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| description | String | Eine Beschreibung des Bereitstellungsprofils. Die maximal zulässige Länge beträgt 1500 Zeichen. Unterstützt: $select, $top, $skip, $orderBy. $Search und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| language | String | Der Sprachcode, der beim Konfigurieren des Geräts verwendet werden soll. Beispiel: en-US. Der Standardwert ist os-default. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Schreibgeschützt. Ab Mai 2024 wird diese Eigenschaft nicht mehr unterstützt und als veraltet markiert. Verwenden Sie stattdessen das Gebietsschema. Geerbt von windowsAutopilotDeploymentProfile |
| Gebietsschema | String | Das Gebietsschema (Sprache), das beim Konfigurieren des Geräts verwendet werden soll. Beispiel: en-US. Der Standardwert ist os-default. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit der Erstellung des Bereitstellungsprofils. Der Wert kann nicht geändert werden und wird automatisch aufgefüllt, wenn das Profil erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Schreibgeschützt. Geerbt von windowsAutopilotDeploymentProfile |
| lastModifiedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Änderung des Bereitstellungsprofils. Der Wert kann nicht manuell aktualisiert werden und wird automatisch aufgefüllt, wenn Änderungen am Profil vorgenommen werden. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht schreibgeschützt unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| outOfBoxExperienceSettings | outOfBoxExperienceSettings | Die Windows Autopilot Deployment Profileinstellungen, die vom Autopilot-Gerät für eine sofort einsatzbereite Benutzeroberfläche verwendet werden. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Schreibgeschützt. Ab Mai 2024 wird diese Eigenschaft nicht mehr unterstützt und als veraltet markiert. Verwenden Sie stattdessen outOfBoxExperienceSetting. Geerbt von windowsAutopilotDeploymentProfile |
| outOfBoxExperienceSetting | outOfBoxExperienceSetting | Die Windows Autopilot Deployment Profileinstellungen, die vom Gerät für die standardmäßige Benutzeroberfläche verwendet werden. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| enrollmentStatusScreenSettings | windowsEnrollmentStatusScreenSettings | Registrierungs- status Bildschirmeinstellung geerbt von windowsAutopilotDeploymentProfile |
| extractHardwareHash | Boolesch | Gibt an, ob das Profil die Extraktion von Hardwarehashwerten und die Registrierung des Geräts in Windows Autopilot unterstützt. Gibt bei TRUE an, ob die Hardwareextraktion und die Windows Autopilot-Registrierung beim nächsten erfolgreichen Einchecken erfolgen. Bei FALSE erfolgt die Hardwarehashextraktion und die Windows Autopilot-Registrierung nicht. Der Standardwert ist FALSE. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Schreibgeschützt. Ab Mai 2024 wird diese Eigenschaft nicht mehr unterstützt und als veraltet markiert. Verwenden Sie stattdessen hardwareHashExtractionEnabled. Geerbt von windowsAutopilotDeploymentProfile |
| hardwareHashExtractionEnabled | Boolesch | Gibt an, ob das Profil die Extraktion von Hardwarehashwerten und die Registrierung des Geräts in Windows Autopilot unterstützt. Gibt bei TRUE an, ob die Hardwareextraktion und die Windows Autopilot-Registrierung beim nächsten erfolgreichen Einchecken erfolgen. Bei FALSE erfolgt die Hardwarehashextraktion und die Windows Autopilot-Registrierung nicht. Der Standardwert ist FALSE. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| deviceNameTemplate | String | Die Vorlage, die zum Benennen des Autopilot-Geräts verwendet wird. Dies kann ein benutzerdefinierter Text sein und kann auch entweder die Seriennummer des Geräts oder eine zufällig generierte Zahl enthalten. Die Gesamtlänge des von der Vorlage generierten Texts darf maximal 15 Zeichen betragen. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| deviceType | windowsAutopilotDeviceType | Der Windows-Gerätetyp, für den dieses Profil gilt. Mögliche Werte sind windowsPc, holoLens und virtualMachine. Der Standardwert ist windowsPc. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile. Mögliche Werte sind: windowsPc, surfaceHub2, holoLens, surfaceHub2S, virtualMachine und unknownFutureValue. |
| enableWhiteGlove | Boolesch | Gibt an, ob der Benutzer Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus während der Out-of-Box-Erfahrung (OOBE) verwenden darf. Gibt bei TRUE an, dass Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus zulässig ist. Bei false ist Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus nicht zulässig. Die Standardeinstellung ist FALSE. Schreibgeschützt. Ab Mai 2024 wird diese Eigenschaft nicht mehr unterstützt und als veraltet markiert. Verwenden Sie stattdessen preprovisioningAllowed. Geerbt von windowsAutopilotDeploymentProfile |
| PreprovisioningAllowed | Boolesch | Gibt an, ob der Benutzer Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus während der Out-of-Box-Erfahrung (OOBE) verwenden darf. Gibt bei TRUE an, dass Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus für OOBE verwendet werden darf. Bei false ist Windows Autopilot für den vorab bereitgestellten Bereitstellungsmodus für OOBE nicht zulässig. Die Standardeinstellung ist FALSE. Geerbt von windowsAutopilotDeploymentProfile |
| roleScopeTagIds | String collection | Liste der Rollenbereichstags für das Bereitstellungsprofil. Geerbt von windowsAutopilotDeploymentProfile |
| managementServiceAppId | String | Die App-ID des Entra-Verwaltungsdiensts, die bei der ermittlung der clientgerätebasierten Registrierung verwendet wird. Unterstützt: $select, $top, $skip. $Search, $orderBy und $filter werden nicht unterstützt. Geerbt von windowsAutopilotDeploymentProfile |
| hybridAzureADJoinSkipConnectivityCheck | Boolesch | Der Autopilot-Hybrid-Azure AD-Einbindungsflow wird auch dann fortgesetzt, wenn er während der OOBE keine Domänencontrollerkonnektivität herstellt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein activeDirectoryWindowsAutopilotDeploymentProfile-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/beta/deviceManagement/windowsAutopilotDeploymentProfiles
Content-type: application/json
Content-length: 1690
{
"@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile",
"displayName": "Display Name value",
"description": "Description value",
"language": "Language value",
"locale": "Locale value",
"outOfBoxExperienceSettings": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
"hidePrivacySettings": true,
"hideEULA": true,
"userType": "standard",
"deviceUsageType": "shared",
"skipKeyboardSelectionPage": true,
"hideEscapeLink": true
},
"outOfBoxExperienceSetting": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
"privacySettingsHidden": true,
"eulaHidden": true,
"userType": "standard",
"deviceUsageType": "shared",
"keyboardSelectionPageSkipped": true,
"escapeLinkHidden": true
},
"enrollmentStatusScreenSettings": {
"@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
"hideInstallationProgress": true,
"allowDeviceUseBeforeProfileAndAppInstallComplete": true,
"blockDeviceSetupRetryByUser": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true
},
"extractHardwareHash": true,
"hardwareHashExtractionEnabled": true,
"deviceNameTemplate": "Device Name Template value",
"deviceType": "surfaceHub2",
"enableWhiteGlove": true,
"preprovisioningAllowed": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"managementServiceAppId": "Management Service App Id value",
"hybridAzureADJoinSkipConnectivityCheck": true
}
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: 1862
{
"@odata.type": "#microsoft.graph.activeDirectoryWindowsAutopilotDeploymentProfile",
"id": "49fe234a-234a-49fe-4a23-fe494a23fe49",
"displayName": "Display Name value",
"description": "Description value",
"language": "Language value",
"locale": "Locale value",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"outOfBoxExperienceSettings": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
"hidePrivacySettings": true,
"hideEULA": true,
"userType": "standard",
"deviceUsageType": "shared",
"skipKeyboardSelectionPage": true,
"hideEscapeLink": true
},
"outOfBoxExperienceSetting": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
"privacySettingsHidden": true,
"eulaHidden": true,
"userType": "standard",
"deviceUsageType": "shared",
"keyboardSelectionPageSkipped": true,
"escapeLinkHidden": true
},
"enrollmentStatusScreenSettings": {
"@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
"hideInstallationProgress": true,
"allowDeviceUseBeforeProfileAndAppInstallComplete": true,
"blockDeviceSetupRetryByUser": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true
},
"extractHardwareHash": true,
"hardwareHashExtractionEnabled": true,
"deviceNameTemplate": "Device Name Template value",
"deviceType": "surfaceHub2",
"enableWhiteGlove": true,
"preprovisioningAllowed": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"managementServiceAppId": "Management Service App Id value",
"hybridAzureADJoinSkipConnectivityCheck": true
}
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für