create depEnrollmentProfile

Namespace: microsoft.graph

Wichtig: Microsoft Graph APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Erstellt ein neues depEnrollmentProfile-Objekt .

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementServiceConfig.ReadWrite.All

HTTP-Anforderung

POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer<token> erforderlich
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des depEnrollmentProfile-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typ "depEnrollmentProfile" erstellen.

Eigenschaft	Typ	Beschreibung
id	String	Die GUID für das Von enrollmentProfile geerbte Objekt
displayName	Zeichenfolge	Name des profils geerbt von enrollmentProfile
description	String	Beschreibung des profils Geerbt von enrollmentProfile
requiresUserAuthentication	Boolesch	Gibt an, ob für das Profil die Benutzerauthentifizierung erforderlich ist. Geerbt von enrollmentProfile
configurationEndpointUrl	Zeichenfolge	Url des Konfigurationsendpunkts, die für die Registrierung verwendet werden soll. Geerbt von enrollmentProfile
enableAuthenticationViaCompanyPortal	Boolesch	Gibt an, dass die Authentifizierung mit dem Apple Setup-Assistenten anstelle von Unternehmensportal erfolgen soll. Geerbt von enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevices	Boolesch	Gibt an, dass Unternehmensportal auf registrierten Geräten des Setup-Assistenten erforderlich ist. Geerbt von enrollmentProfile
isDefault	Boolean	Gibt an, ob dies das Standardprofil ist
supervisedModeEnabled	Boolesch	Überwachter Modus, "True zu aktivieren", andernfalls "false". Weitere Informationen finden Sie unter "Registrieren von Geräten in Microsoft Intune".
supportDepartment	String	Supportabteilungsinformationen
passCodeDisabled	Boolesch	Gibt an, ob der Kennungs-Setupbereich deaktiviert ist.
isMandatory	Boolesch	Gibt an, ob das Profil obligatorisch ist
locationDisabled	Boolesch	Gibt an, ob der Einrichtungsbereich des Standortdiensts deaktiviert ist.
supportPhoneNumber	Zeichenfolge	Supporttelefonnummer
iTunesPairingMode	iTunesPairingMode	Gibt den iTunes-Kopplungsmodus an. Mögliche Werte sind: disallow, allow und requiresCertificate.
profileRemovalDisabled	Boolesch	Gibt an, ob die Option zum Entfernen von Profilen deaktiviert ist.
managementCertificates	managementCertificateWithThumbprint-Sammlung	Verwaltungszertifikate für Apple Configurator
restoreBlocked	Boolesch	Gibt an, ob der Einrichtungsbereich "Wiederherstellen" blockiert ist.
restoreFromAndroidDisabled	Boolesch	Gibt an, ob die Wiederherstellung aus Android deaktiviert ist.
appleIdDisabled	Boolesch	Gibt an, ob der Apple-ID-Einrichtungsbereich deaktiviert ist.
termsAndConditionsDisabled	Boolesch	Gibt an, ob der Einrichtungsbereich "Geschäftsbedingungen" deaktiviert ist.
touchIdDisabled	Boolesch	Gibt an, ob der Einrichtungsbereich der Touch-ID deaktiviert ist.
applePayDisabled	Boolesch	Gibt an, ob der Apple Pay-Einrichtungsbereich deaktiviert ist.
zoomDisabled	Boolesch	Gibt an, ob der Zoom-Einrichtungsbereich deaktiviert ist.
siriDisabled	Boolesch	Gibt an, ob der Siri-Setupbereich deaktiviert ist.
diagnosticsDisabled	Boolesch	Gibt an, ob der Einrichtungsbereich der Diagnose deaktiviert ist
macOSRegistrationDisabled	Boolesch	Gibt an, ob die Mac OS-Registrierung deaktiviert ist.
macOSFileVaultDisabled	Boolesch	Gibt an, ob der Mac OS-Dateitresor deaktiviert ist.
awaitDeviceConfiguredConfirmation	Boolesch	Gibt an, ob das Gerät auf die konfigurierte Bestätigung warten muss.
sharedIPadMaximumUserCount	Int32	Dies gibt die maximale Anzahl von Benutzern an, die ein freigegebenes iPad verwenden können. Gilt nur im Modus für freigegebene iPad.
enableSharedIPad	Boolesch	Dies gibt an, ob das Gerät in einem Modus registriert werden soll, der Szenarien mit mehreren Benutzern ermöglicht. Gilt nur für freigegebene iPads.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein depEnrollmentProfile-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
Content-type: application/json
Content-length: 1354

{
  "@odata.type": "#microsoft.graph.depEnrollmentProfile",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "iTunesPairingMode": "allow",
  "profileRemovalDisabled": true,
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreBlocked": true,
  "restoreFromAndroidDisabled": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "macOSRegistrationDisabled": true,
  "macOSFileVaultDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": 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: 1403

{
  "@odata.type": "#microsoft.graph.depEnrollmentProfile",
  "id": "3d4534f7-34f7-3d45-f734-453df734453d",
  "displayName": "Display Name value",
  "description": "Description value",
  "requiresUserAuthentication": true,
  "configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
  "enableAuthenticationViaCompanyPortal": true,
  "requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
  "isDefault": true,
  "supervisedModeEnabled": true,
  "supportDepartment": "Support Department value",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "iTunesPairingMode": "allow",
  "profileRemovalDisabled": true,
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreBlocked": true,
  "restoreFromAndroidDisabled": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": true,
  "siriDisabled": true,
  "diagnosticsDisabled": true,
  "macOSRegistrationDisabled": true,
  "macOSFileVaultDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true
}