Erstellen von depMacOSEnrollmentProfile
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 depMacOSEnrollmentProfile-Objekt .
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
POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
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 depMacOSEnrollmentProfile-Objekt an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von depMacOSEnrollmentProfile erforderlich sind.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | String | Die GUID für das von enrollmentProfile geerbte Objekt |
| displayName | String | Name des Profils, das von enrollmentProfile geerbt wurde |
| description | String | Beschreibung des Profils, das von enrollmentProfile geerbt wurde |
| requiresUserAuthentication | Boolesch | Gibt an, ob das Profil eine Benutzerauthentifizierung erfordert, die von enrollmentProfile geerbt wurde. |
| configurationEndpointUrl | String | Konfigurationsendpunkt-URL, die für die von enrollmentProfile geerbte Registrierung verwendet werden soll |
| enableAuthenticationViaCompanyPortal | Boolesch | Gibt an, dass die Authentifizierung mit dem Apple-Setup-Assistenten anstelle von Unternehmensportal erfolgt. Geerbt von enrollmentProfile |
| requireCompanyPortalOnSetupAssistantEnrolledDevices | Boolesch | Gibt an, dass Unternehmensportal beim Setup Assistent registrierten Geräte erforderlich ist, die von enrollmentProfile geerbt wurden. |
| isDefault | Boolesch | Gibt an, ob dies das Standardprofil ist, das von depEnrollmentBaseProfile geerbt wurde. |
| supervisedModeEnabled | Boolesch | Überwachter Modus, Zu aktivierende True, andernfalls false. Weitere Informationen finden Sie https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune unter . Geerbt von depEnrollmentBaseProfile |
| supportDepartment | String | Supportabteilungsinformationen geerbt von depEnrollmentBaseProfile |
| isMandatory | Boolesch | Gibt an, ob das Profil obligatorisch ist Geerbt von depEnrollmentBaseProfile |
| locationDisabled | Boolesch | Gibt an, ob der Bereich "Standortdienst einrichten" deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| supportPhoneNumber | String | Supporttelefonnummer geerbt von depEnrollmentBaseProfile |
| profileRemovalDisabled | Boolesch | Gibt an, ob die Option zum Entfernen des Profils deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| restoreBlocked | Boolesch | Gibt an, ob der Bereich "Setup wiederherstellen" blockiert ist. Geerbt von depEnrollmentBaseProfile |
| appleIdDisabled | Boolesch | Gibt an, ob der Bereich "Apple ID-Setup" deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| termsAndConditionsDisabled | Boolesch | Gibt an, ob der Setupbereich "Geschäftsbedingungen" deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| touchIdDisabled | Boolesch | Gibt an, ob der Touch-ID-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| applePayDisabled | Boolesch | Gibt an, ob der Apple Pay-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| siriDisabled | Boolesch | Gibt an, ob der Siri-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| diagnosticsDisabled | Boolesch | Gibt an, ob Diagnose Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| displayToneSetupDisabled | Boolesch | Gibt an, ob displaytone setup screen deaktiviert ist Geerbt von depEnrollmentBaseProfile |
| privacyPaneDisabled | Boolesch | Gibt an, ob der Datenschutzbildschirm deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| screenTimeScreenDisabled | Boolesch | Gibt an, ob das Setup des Bildschirmtimeouts deaktiviert ist. Geerbt von depEnrollmentBaseProfile |
| deviceNameTemplate | String | Legt ein Literal- oder Namensmuster fest. Geerbt von depEnrollmentBaseProfile |
| configurationWebUrl | Boolesch | URL zum Einrichten Assistent Anmeldung geerbt von depEnrollmentBaseProfile |
| enabledSkipKeys | String collection | enabledSkipKeys enthält alle aktivierten Skip-Schlüssel als Zeichenfolgen, die von depEnrollmentBaseProfile geerbt wurden. |
| enrollmentTimeAzureAdGroupIds | GUID-Sammlung | EnrollmentTimeAzureAdGroupIds enthält eine Liste der Registrierungszeit-Azure-Gruppen-IDs, die dem Profil zugeordnet werden sollen. Geerbt von depEnrollmentBaseProfile |
| waitForDeviceConfiguredConfirmation | Boolesch | Gibt an, ob das Gerät auf die konfigurierte Bestätigung warten muss. Geerbt von depEnrollmentBaseProfile |
| registrationDisabled | Boolesch | Gibt an, ob die Registrierung deaktiviert ist. |
| fileVaultDisabled | Boolesch | Gibt an, ob der Dateitresor deaktiviert ist. |
| iCloudDiagnosticsDisabled | Boolesch | Gibt an, ob der iCloud Analytics-Bildschirm deaktiviert ist. |
| passCodeDisabled | Boolesch | Gibt an, ob der Bereich "Kennungseinrichtung" deaktiviert ist. |
| zoomDisabled | Boolesch | Gibt an, ob der Zoom-Setupbereich deaktiviert ist. |
| iCloudStorageDisabled | Boolesch | Gibt an, ob der Bildschirm "iCloud-Dokumente und -Desktop" deaktiviert ist. |
| chooseYourLockScreenDisabled | Boolesch | Gibt an, ob der Bildschirm "iCloud-Dokumente und -Desktop" deaktiviert ist. |
| accessibilityScreenDisabled | Boolesch | Gibt an, ob der Bildschirm "Barrierefreiheit" deaktiviert ist. |
| autoUnlockWithWatchDisabled | Boolesch | Gibt an, ob der UnlockWithWatch-Bildschirm deaktiviert ist. |
| skipPrimarySetupAccountCreation | Boolesch | Gibt an, ob der Setup-Assistent die Benutzeroberfläche für die Einrichtung des primären Kontos überspringt. |
| setPrimarySetupAccountAsRegularUser | Boolesch | Gibt an, ob der Setup-Assistent das Konto als regulärer Benutzer festlegen wird. |
| dontAutoPopulatePrimaryAccountInfo | Boolesch | Gibt an, ob der Setup-Assistent die Informationen des primären Kontos automatisch auffüllt. |
| primaryAccountFullName | String | Gibt den vollständigen Namen für das primäre Konto an. |
| primaryAccountUserName | String | Gibt den Kontonamen für das primäre Konto an. |
| enableRestrictEditing | Boolesch | Gibt an, ob der Benutzer blockediting aktiviert. |
| adminAccountUserName | String | Gibt den Benutzernamen für das Administratorkonto an. |
| adminAccountFullName | String | Gibt den vollständigen Namen für das Administratorkonto an. |
| adminAccountPassword | String | Gibt das Kennwort für das Administratorkonto an. |
| hideAdminAccount | Boolesch | Gibt an, ob das Administratorkonto ausgeblendet werden soll oder nicht. |
| requestRequiresNetworkTether | Boolesch | Gibt an, ob das Gerät netzwerkgebunden ist, um den Befehl auszuführen. |
| autoAdvanceSetupEnabled | Boolesch | Gibt an, ob der Setup-Assistent automatisch über den Bildschirm wechselt |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein depMacOSEnrollmentProfile-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: 2123
{
"@odata.type": "#microsoft.graph.depMacOSEnrollmentProfile",
"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",
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"profileRemovalDisabled": true,
"restoreBlocked": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"displayToneSetupDisabled": true,
"privacyPaneDisabled": true,
"screenTimeScreenDisabled": true,
"deviceNameTemplate": "Device Name Template value",
"configurationWebUrl": true,
"enabledSkipKeys": [
"Enabled Skip Keys value"
],
"enrollmentTimeAzureAdGroupIds": [
"7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
],
"waitForDeviceConfiguredConfirmation": true,
"registrationDisabled": true,
"fileVaultDisabled": true,
"iCloudDiagnosticsDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"iCloudStorageDisabled": true,
"chooseYourLockScreenDisabled": true,
"accessibilityScreenDisabled": true,
"autoUnlockWithWatchDisabled": true,
"skipPrimarySetupAccountCreation": true,
"setPrimarySetupAccountAsRegularUser": true,
"dontAutoPopulatePrimaryAccountInfo": true,
"primaryAccountFullName": "Primary Account Full Name value",
"primaryAccountUserName": "Primary Account User Name value",
"enableRestrictEditing": true,
"adminAccountUserName": "Admin Account User Name value",
"adminAccountFullName": "Admin Account Full Name value",
"adminAccountPassword": "Admin Account Password value",
"hideAdminAccount": true,
"requestRequiresNetworkTether": true,
"autoAdvanceSetupEnabled": 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: 2172
{
"@odata.type": "#microsoft.graph.depMacOSEnrollmentProfile",
"id": "e433c95c-c95c-e433-5cc9-33e45cc933e4",
"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",
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"profileRemovalDisabled": true,
"restoreBlocked": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"displayToneSetupDisabled": true,
"privacyPaneDisabled": true,
"screenTimeScreenDisabled": true,
"deviceNameTemplate": "Device Name Template value",
"configurationWebUrl": true,
"enabledSkipKeys": [
"Enabled Skip Keys value"
],
"enrollmentTimeAzureAdGroupIds": [
"7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
],
"waitForDeviceConfiguredConfirmation": true,
"registrationDisabled": true,
"fileVaultDisabled": true,
"iCloudDiagnosticsDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"iCloudStorageDisabled": true,
"chooseYourLockScreenDisabled": true,
"accessibilityScreenDisabled": true,
"autoUnlockWithWatchDisabled": true,
"skipPrimarySetupAccountCreation": true,
"setPrimarySetupAccountAsRegularUser": true,
"dontAutoPopulatePrimaryAccountInfo": true,
"primaryAccountFullName": "Primary Account Full Name value",
"primaryAccountUserName": "Primary Account User Name value",
"enableRestrictEditing": true,
"adminAccountUserName": "Admin Account User Name value",
"adminAccountFullName": "Admin Account Full Name value",
"adminAccountPassword": "Admin Account Password value",
"hideAdminAccount": true,
"requestRequiresNetworkTether": true,
"autoAdvanceSetupEnabled": true
}
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für