Aktualisieren von depIOSEnrollmentProfile

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.

Aktualisiert die Eigenschaften eines depIOSEnrollmentProfile-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/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile

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 depIOSEnrollmentProfile-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von depIOSEnrollmentProfile 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
iTunesPairingMode	iTunesPairingMode	Gibt den iTunes-Kopplungsmodus an. Mögliche Werte sind: disallow, allow und requiresCertificate.
managementZertifikate	managementCertificateWithThumbprint-Sammlung	Verwaltungszertifikate für Apple Configurator
restoreFromAndroidDisabled	Boolesch	Gibt an, ob die Wiederherstellung von Android 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 gemeinsam genutzten iPad-Modus.
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.
companyPortalVppTokenId	String	Wenn festgelegt, gibt an, welches Vpp-Token zum Bereitstellen des Unternehmensportal mit Gerätelizenzierung verwendet werden soll. "enableAuthenticationViaCompanyPortal" muss festgelegt werden, damit diese Eigenschaft festgelegt wird.
enableSingleAppEnrollmentMode	Boolesch	Weist das Gerät an, den Einzel-App-Modus zu aktivieren und die App-Sperre während der Registrierung anzuwenden. Der Standardwert ist „false“. "enableAuthenticationViaCompanyPortal" und "companyPortalVppTokenId" müssen festgelegt werden, damit diese Eigenschaft festgelegt wird.
homeButtonScreenDisabled	Boolesch	Gibt an, ob der Vertraulichkeitsbildschirm der Startschaltfläche deaktiviert ist.
iMessageAndFaceTimeScreenDisabled	Boolesch	Gibt an, ob der Bildschirm "iMessage" und "FaceTime" deaktiviert ist.
onBoardingScreenDisabled	Boolesch	Gibt an, ob der Setupbildschirm für das Onboarding deaktiviert ist.
simSetupScreenDisabled	Boolesch	Gibt an, ob der SIMSetup-Bildschirm deaktiviert ist.
softwareUpdateScreenDisabled	Boolesch	Gibt an, ob der Bildschirm für das obligatorische Sofwareupdate deaktiviert ist.
watchMigrationScreenDisabled	Boolesch	Gibt an, ob der watch Migrationsbildschirm deaktiviert ist.
appearanceScreenDisabled	Boolesch	Gibt an, ob der Apperance-Bildschirm deaktiviert ist.
expressLanguageScreenDisabled	Boolesch	Gibt an, ob der Bildschirm "Express Language" deaktiviert ist.
preferredLanguageScreenDisabled	Boolesch	Gibt an, ob der Bildschirm "Bevorzugte Sprache" deaktiviert ist.
deviceToDeviceMigrationDisabled	Boolesch	Gibt an, ob die Migration von Gerät zu Gerät deaktiviert ist.
welcomeScreenDisabled	Boolesch	Gibt an, ob der Weclome-Bildschirm deaktiviert ist.
passCodeDisabled	Boolesch	Gibt an, ob der Bereich "Kennungseinrichtung" deaktiviert ist.
zoomDisabled	Boolesch	Gibt an, ob der Zoom-Setupbereich deaktiviert ist.
restoreCompletedScreenDisabled	Boolesch	Gibt an, ob der Weclome-Bildschirm deaktiviert ist.
updateCompleteScreenDisabled	Boolesch	Gibt an, ob der Weclome-Bildschirm deaktiviert ist.
forceTemporarySession	Boolesch	Gibt an, ob temporäre Sitzungen aktiviert sind.
temporarySessionTimeoutInSeconds	Int32	Gibt das Timeout der temporären Sitzung an.
userSessionTimeoutInSeconds	Int32	Gibt das Timeout der temporären Sitzung an.
passcodeLockGracePeriodInSeconds	Int32	Gibt ein Timeout an, bevor der gesperrte Bildschirm erfordert, dass der Benutzer die Gerätepassocde eingeben muss, um es zu entsperren.
carrierActivationUrl	String	Carrier-URL zum Aktivieren der Geräte-eSIM.
userlessSharedAadModeEnabled	Boolesch	Gibt an, dass dieses Apple-Gerät für die Unterstützung des Modus für gemeinsam genutzte Geräte vorgesehen ist. Dies unterscheidet sich vom Szenario "gemeinsam genutztes iPad". Siehe https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios|

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode und ein aktualisiertes depIOSEnrollmentProfile-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile
Content-type: application/json
Content-length: 2574

{
  "@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
  "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,
  "iTunesPairingMode": "allow",
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreFromAndroidDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true,
  "companyPortalVppTokenId": "Company Portal Vpp Token Id value",
  "enableSingleAppEnrollmentMode": true,
  "homeButtonScreenDisabled": true,
  "iMessageAndFaceTimeScreenDisabled": true,
  "onBoardingScreenDisabled": true,
  "simSetupScreenDisabled": true,
  "softwareUpdateScreenDisabled": true,
  "watchMigrationScreenDisabled": true,
  "appearanceScreenDisabled": true,
  "expressLanguageScreenDisabled": true,
  "preferredLanguageScreenDisabled": true,
  "deviceToDeviceMigrationDisabled": true,
  "welcomeScreenDisabled": true,
  "passCodeDisabled": true,
  "zoomDisabled": true,
  "restoreCompletedScreenDisabled": true,
  "updateCompleteScreenDisabled": true,
  "forceTemporarySession": true,
  "temporarySessionTimeoutInSeconds": 0,
  "userSessionTimeoutInSeconds": 11,
  "passcodeLockGracePeriodInSeconds": 0,
  "carrierActivationUrl": "https://example.com/carrierActivationUrl/",
  "userlessSharedAadModeEnabled": 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: 2623

{
  "@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
  "id": "1ec10a60-0a60-1ec1-600a-c11e600ac11e",
  "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,
  "iTunesPairingMode": "allow",
  "managementCertificates": [
    {
      "@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
      "thumbprint": "Thumbprint value",
      "certificate": "Certificate value"
    }
  ],
  "restoreFromAndroidDisabled": true,
  "awaitDeviceConfiguredConfirmation": true,
  "sharedIPadMaximumUserCount": 10,
  "enableSharedIPad": true,
  "companyPortalVppTokenId": "Company Portal Vpp Token Id value",
  "enableSingleAppEnrollmentMode": true,
  "homeButtonScreenDisabled": true,
  "iMessageAndFaceTimeScreenDisabled": true,
  "onBoardingScreenDisabled": true,
  "simSetupScreenDisabled": true,
  "softwareUpdateScreenDisabled": true,
  "watchMigrationScreenDisabled": true,
  "appearanceScreenDisabled": true,
  "expressLanguageScreenDisabled": true,
  "preferredLanguageScreenDisabled": true,
  "deviceToDeviceMigrationDisabled": true,
  "welcomeScreenDisabled": true,
  "passCodeDisabled": true,
  "zoomDisabled": true,
  "restoreCompletedScreenDisabled": true,
  "updateCompleteScreenDisabled": true,
  "forceTemporarySession": true,
  "temporarySessionTimeoutInSeconds": 0,
  "userSessionTimeoutInSeconds": 11,
  "passcodeLockGracePeriodInSeconds": 0,
  "carrierActivationUrl": "https://example.com/carrierActivationUrl/",
  "userlessSharedAadModeEnabled": true
}