windowsAutopilotDeploymentProfile-Ressourcentyp
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.
Windows Autopilot Deployment-Profil
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| WindowsAutopilotDeploymentProfile abrufen | windowsAutopilotDeploymentProfile | Lesen von Eigenschaften und Beziehungen des windowsAutopilotDeploymentProfile-Objekts . |
| Aktion zuweisen | Keine | |
| Richtliniensatz | ||
| hasPayloadLinks-Aktion | hasPayloadLinkResultItem-Sammlung |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| enrollmentStatusScreenSettings | windowsEnrollmentStatusScreenSettings | Registrierungs-status-Bildschirmeinstellung |
| 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. |
| 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. |
| 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. |
| 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. 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. |
| 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. |
| roleScopeTagIds | String collection | Liste der Rollenbereichstags für das Bereitstellungsprofil. |
| 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. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Registrierung | ||
| assignedDevices | windowsAutopilotDeviceIdentity-Sammlung | Die Liste der zugewiesenen Geräte für das Profil. |
| assignments | windowsAutopilotDeploymentProfileAssignment-Sammlung | Die Liste der Gruppenzuweisungen für das Profil. |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"@odata.type": "#microsoft.graph.windowsAutopilotDeploymentProfile",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"language": "String",
"locale": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"outOfBoxExperienceSettings": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSettings",
"hidePrivacySettings": true,
"hideEULA": true,
"userType": "String",
"deviceUsageType": "String",
"skipKeyboardSelectionPage": true,
"hideEscapeLink": true
},
"outOfBoxExperienceSetting": {
"@odata.type": "microsoft.graph.outOfBoxExperienceSetting",
"privacySettingsHidden": true,
"eulaHidden": true,
"userType": "String",
"deviceUsageType": "String",
"keyboardSelectionPageSkipped": true,
"escapeLinkHidden": true
},
"enrollmentStatusScreenSettings": {
"@odata.type": "microsoft.graph.windowsEnrollmentStatusScreenSettings",
"hideInstallationProgress": true,
"allowDeviceUseBeforeProfileAndAppInstallComplete": true,
"blockDeviceSetupRetryByUser": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "String",
"installProgressTimeoutInMinutes": 1024,
"allowDeviceUseOnInstallFailure": true
},
"extractHardwareHash": true,
"hardwareHashExtractionEnabled": true,
"deviceNameTemplate": "String",
"deviceType": "String",
"enableWhiteGlove": true,
"preprovisioningAllowed": true,
"roleScopeTagIds": [
"String"
],
"managementServiceAppId": "String"
}