Aktualisieren von windows10EnrollmentCompletionPageConfiguration

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.

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

PATCH /deviceManagement/deviceEnrollmentConfigurations/{deviceEnrollmentConfigurationId}

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 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
}