windows10EnrollmentCompletionPageConfiguration aktualisieren
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.
Aktualisieren Sie die Eigenschaften eines windows10EnrollmentCompletionPageConfiguration-Objekts .
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
PATCH /deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
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 windows10EnrollmentCompletionPageConfiguration an .
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von windows10EnrollmentCompletionPageConfiguration erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Eindeutiger Bezeichner für das Konto, das von deviceEnrollmentConfiguration geerbt wurde |
| displayName | String | Der Anzeigename der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde. |
| description | String | Die Beschreibung der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde. |
| Priorität | Int32 | Priorität wird verwendet, wenn ein Benutzer in mehreren Gruppen vorhanden ist, denen die Registrierungskonfiguration zugewiesen ist. Benutzer unterliegen nur der Konfiguration mit dem niedrigsten Prioritätswert. Geerbt von deviceEnrollmentConfiguration |
| createdDateTime | DateTimeOffset | Datum und Uhrzeit der Erstellung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration |
| lastModifiedDateTime | DateTimeOffset | Datum der letzten Änderung in UTC der Geräteregistrierungskonfiguration geerbt von deviceEnrollmentConfiguration |
| Version | Int32 | Die Version der Geräteregistrierungskonfiguration, die von deviceEnrollmentConfiguration geerbt wurde |
| roleScopeTagIds | Zeichenfolgensammlung | Optionale Rollenbereichstags für die Registrierungseinschränkungen. Geerbt von deviceEnrollmentConfiguration |
| deviceEnrollmentConfigurationType | deviceEnrollmentConfigurationType | Unterstützung für registrierungskonfigurationstyp Geerbt von deviceEnrollmentConfiguration. Mögliche Werte: unknown, limit, platformRestrictions, windowsHelloForBusiness, defaultLimit, defaultPlatformRestrictions, defaultWindowsHelloForBusiness, defaultWindows10EnrollmentCompletionPageConfiguration, windows10EnrollmentCompletionPageConfiguration, deviceComanagementAuthorityConfiguration, singlePlatformRestriction, unknownFutureValue, enrollmentNotificationsConfiguration. |
| showInstallationProgress | Boolesch | Bei TRUE zeigt dem Benutzer den Installationsfortschritt an. Bei false blendet den Installationsfortschritt aus. Der Standardwert ist „false“. |
| blockDeviceSetupRetryByUser | Boolesch | Bei TRUE wird verhindert, dass der Benutzer das Setup bei Installationsfehlern wiederholt. Bei "false" darf der Benutzer den Vorgang wiederholen. Der Standardwert ist „false“. |
| allowDeviceResetOnInstallFailure | Boolesch | Bei TRUE lässt das Zurücksetzen des Geräts bei installationsfehlern zu. Bei false wird das Zurücksetzen blockiert. Der Standardwert ist „false“. |
| allowLogCollectionOnInstallFailure | Boolesch | Bei TRUE lässt die Protokollsammlung bei Installationsfehlern zu. Bei false ist die Protokollsammlung nicht zulässig. Der Standardwert ist „false“. |
| customErrorMessage | String | Die benutzerdefinierte Fehlermeldung, die bei einem Installationsfehler angezeigt werden soll. Die maximale Länge beträgt 10.000. Beispiel: "Setup konnte nicht abgeschlossen werden. Bitte versuchen Sie es erneut oder wenden Sie sich an Ihren Support-Mitarbeiter, um Hilfe zu erhalten." |
| installProgressTimeoutInMinutes | Int32 | Das Timeout des Installationsfortschritts in Minuten. Der Standardwert ist 60 Minuten. |
| allowDeviceUseOnInstallFailure | Boolesch | Bei TRUE kann der Benutzer das Gerät bei einem Installationsfehler weiterhin verwenden. Bei "false" wird der Benutzer bei installationsfehlern blockiert. Der Standardwert ist „false“. |
| selectedMobileAppIds | String collection | Ausgewählte Anwendungen zum Nachverfolgen der Installations-status. Es liegt in Form eines Arrays von GUIDs vor. |
| allowNonBlockingAppInstallation | Boolesch | Bei TRUE installiert ESP (Registrierungsstatusseite) alle erforderlichen Apps, die während der Technikerphase verwendet werden, und ignoriert alle Fehler für nicht blockierende Apps. Bei FALSE schlägt ESP bei einem Fehler während der App-Installation fehl. Der Standardwert ist „false“. |
| installQualityUpdates | Boolesch | Ermöglicht die Installation von Qualitätsupdates während der OOBE |
| trackInstallProgressForAutopilotOnly | Boolesch | Bei TRUE wird der Installationsfortschritt nur für Autopilot-Registrierungsszenarien nachverfolgt. Bei "false" werden auch andere Szenarien nachverfolgt. Der Standardwert ist „false“. |
| disableUserStatusTrackingAfterFirstUser | Boolesch | Bei TRUE wird die Anzeige des Installationsfortschritts für den ersten Benutzer nach der Registrierung deaktiviert. Wenn false, aktiviert die Anzeige des Fortschritts. Der Standardwert ist „false“. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes Objekt des Typs windows10EnrollmentCompletionPageConfiguration im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}
Content-type: application/json
Content-length: 873
{
"@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"showInstallationProgress": true,
"blockDeviceSetupRetryByUser": true,
"allowDeviceResetOnInstallFailure": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true,
"selectedMobileAppIds": [
"Selected Mobile App Ids value"
],
"allowNonBlockingAppInstallation": true,
"installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true,
"disableUserStatusTrackingAfterFirstUser": 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 200 OK
Content-Type: application/json
Content-Length: 1045
{
"@odata.type": "#microsoft.graph.windows10EnrollmentCompletionPageConfiguration",
"id": "77bf8248-8248-77bf-4882-bf774882bf77",
"displayName": "Display Name value",
"description": "Description value",
"priority": 8,
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"version": 7,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"deviceEnrollmentConfigurationType": "limit",
"showInstallationProgress": true,
"blockDeviceSetupRetryByUser": true,
"allowDeviceResetOnInstallFailure": true,
"allowLogCollectionOnInstallFailure": true,
"customErrorMessage": "Custom Error Message value",
"installProgressTimeoutInMinutes": 15,
"allowDeviceUseOnInstallFailure": true,
"selectedMobileAppIds": [
"Selected Mobile App Ids value"
],
"allowNonBlockingAppInstallation": true,
"installQualityUpdates": true,
"trackInstallProgressForAutopilotOnly": true,
"disableUserStatusTrackingAfterFirstUser": true
}