azureADWindowsAutopilotDeploymentProfile erstellen

Artikel
11/22/2024

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 azureADWindowsAutopilotDeploymentProfile-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	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 Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das Objekt azureADWindowsAutopilotDeploymentProfile an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von azureADWindowsAutopilotDeploymentProfile 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 werden $orderBy und $filter 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`, `holoLens`, `surfaceHub2`, `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

Antwort

Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und das Objekt azureADWindowsAutopilotDeploymentProfile im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "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": "holoLens",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}

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

{
  "@odata.type": "#microsoft.graph.azureADWindowsAutopilotDeploymentProfile",
  "id": "e2ec4e69-4e69-e2ec-694e-ece2694eece2",
  "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": "holoLens",
  "enableWhiteGlove": true,
  "preprovisioningAllowed": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "managementServiceAppId": "Management Service App Id value"
}

Freigeben über

azureADWindowsAutopilotDeploymentProfile erstellen

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback

Zusätzliche Ressourcen