DepIOSEnrollmentProfile aktualisieren

Artikel
05/05/2022
5 Minuten Lesedauer

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.

Dient zum Aktualisieren der Eigenschaften eines depIOSEnrollmentProfile-Objekts .

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

PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie depIOSEnrollmentProfile erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Die GUID für das Objekt, geerbt von enrollmentProfile
displayName	Zeichenfolge	Name des Profils Geerbt von enrollmentProfile
description	Zeichenfolge	Beschreibung des profils Geerbt von enrollmentProfile
requiresUserAuthentication	Boolean	Gibt an, ob für das Profil eine Benutzerauthentifizierung erforderlich ist. Geerbt von enrollmentProfile
configurationEndpointUrl	Zeichenfolge	Url des Konfigurationsendpunkts, die für die Registrierung verwendet werden soll. Geerbt von enrollmentProfile
enableAuthenticationViaCompanyPortal	Boolean	Gibt an, dass die Authentifizierung beim Apple Setup-Assistenten anstelle von Unternehmensportal erfolgt. Geerbt von enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevices	Boolescher Wert	Gibt an, dass Unternehmensportal auf registrierten Geräten des Setup-Assistenten erforderlich ist. Geerbt von enrollmentProfile
isDefault	Boolean	Gibt an, ob es sich um das Standardprofil handelt, das von depEnrollmentBaseProfile geerbt wird.
supervisedModeEnabled	Boolescher Wert	Überwachter Modus, "True" zum Aktivieren, andernfalls "false". Weitere Informationen finden Sie https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune unter . Geerbt von depEnrollmentBaseProfile
supportDepartment	Zeichenfolge	Supportabteilungsinformationen geerbt von depEnrollmentBaseProfile
isMandatory	Boolean	Gibt an, ob das Profil obligatorisch ist. Geerbt von depEnrollmentBaseProfile
locationDisabled	Boolescher Wert	Gibt an, ob der Einrichtungsbereich des Standortdiensts deaktiviert ist. Geerbt von depEnrollmentBaseProfile
supportPhoneNumber	Zeichenfolge	Supporttelefonnummer geerbt von depEnrollmentBaseProfile
profileRemovalDisabled	Boolean	Gibt an, ob die Option zum Entfernen des Profils deaktiviert ist. Geerbt von depEnrollmentBaseProfile
restoreBlocked	Boolescher Wert	Gibt an, ob der Setupbereich für die Wiederherstellung blockiert ist. Geerbt von depEnrollmentBaseProfile
appleIdDisabled	Boolean	Gibt an, ob der Apple-ID-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile
termsAndConditionsDisabled	Boolescher Wert	Gibt an, ob der Setupbereich "Geschäftsbedingungen" deaktiviert ist. Geerbt von depEnrollmentBaseProfile
touchIdDisabled	Boolean	Gibt an, ob der Einrichtungsbereich für die Touch-ID deaktiviert ist. Geerbt von depEnrollmentBaseProfile
applePayDisabled	Boolesch	Gibt an, ob der Apple Pay-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile
siriDisabled	Boolescher Wert	Gibt an, ob der Siri-Setupbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile
diagnosticsDisabled	Boolescher Wert	Gibt an, ob der Diagnoseeinrichtungsbereich deaktiviert ist. Geerbt von depEnrollmentBaseProfile
displayToneSetupDisabled	Boolean	Gibt an, ob der Anzeigeton-Setupbildschirm deaktiviert ist. Geerbt von depEnrollmentBaseProfile
privacyPaneDisabled	Boolean	Gibt an, ob der Datenschutzbildschirm deaktiviert ist. Geerbt von depEnrollmentBaseProfile
screenTimeScreenDisabled	Boolean	Gibt an, ob das Setup des Bildschirmtimeouts deaktiviert ist. Geerbt von depEnrollmentBaseProfile
deviceNameTemplate	Zeichenfolge	Legt ein Literal- oder Namensmuster fest. Geerbt von depEnrollmentBaseProfile
configurationWebUrl	Boolean	URL für setup assistant login Inherited from depEnrollmentBaseProfile
iTunesPairingMode	iTunesPairingMode	Gibt den iTunes-Kopplungsmodus an. Mögliche Werte sind: `disallow`, `allow` und `requiresCertificate`.
managementCertificates	managementCertificateWithThumbprint-Sammlung	Verwaltungszertifikate für Apple Configurator
restoreFromAndroidDisabled	Boolean	Gibt an, ob die Wiederherstellung von Android deaktiviert ist.
awaitDeviceConfiguredConfirmation	Boolean	Gibt an, ob das Gerät auf die konfigurierte Bestätigung warten muss.
sharedIPadMaximumUserCount	Int32	Dies gibt die maximale Anzahl von Benutzern an, die eine freigegebene iPad verwenden können. Gilt nur im Modus für freigegebene iPad.
enableSharedIPad	Boolean	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	Zeichenfolge	Wenn festgelegt, gibt an, welches Vpp-Token zum Bereitstellen der Unternehmensportal mit Gerätelizenzierung verwendet werden soll. "enableAuthenticationViaCompanyPortal" muss festgelegt werden, damit diese Eigenschaft festgelegt werden kann.
enableSingleAppEnrollmentMode	Boolean	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 werden kann.
homeButtonScreenDisabled	Boolean	Gibt an, ob der Vertraulichkeitsbildschirm der Startschaltfläche deaktiviert ist.
iMessageAndFaceTimeScreenDisabled	Boolean	Gibt an, ob der iMessage- und FaceTime-Bildschirm deaktiviert ist.
onBoardingScreenDisabled	Boolean	Gibt an, ob der Onboarding-Setupbildschirm deaktiviert ist.
simSetupScreenDisabled	Boolean	Gibt an, ob der SIMSetup-Bildschirm deaktiviert ist.
softwareUpdateScreenDisabled	Boolean	Gibt an, ob der obligatorische Sofware-Updatebildschirm deaktiviert ist.
watchMigrationScreenDisabled	Boolean	Gibt an, ob der Überwachungsmigrationsbildschirm deaktiviert ist.
appearanceScreenDisabled	Boolesch	Gibt an, ob der Apperance-Bildschirm deaktiviert ist.
expressLanguageScreenDisabled	Boolean	Gibt an, ob der Bildschirm "Expresssprache" deaktiviert ist.
preferredLanguageScreenDisabled	Boolean	Gibt an, ob der Bildschirm "Bevorzugte Sprache" deaktiviert ist.
deviceToDeviceMigrationDisabled	Boolescher Wert	Gibt an, ob die Migration von Gerät zu Gerät deaktiviert ist.
welcomeScreenDisabled	Boolean	Gibt an, ob der Weclome-Bildschirm deaktiviert ist.
passCodeDisabled	Boolesch	Gibt an, ob der Kennungseinrichtungsbereich deaktiviert ist.
zoomDisabled	Boolesch	Gibt an, ob der Zoomeinrichtungsbereich deaktiviert ist.
restoreCompletedScreenDisabled	Boolesch	Gibt an, ob der Weclome-Bildschirm deaktiviert ist.
updateCompleteScreenDisabled	Boolescher Wert	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 das Timeout vor dem gesperrten Bildschirm an, dass der Benutzer die Gerätekennung eingeben muss, um ihn zu entsperren.
carrierActivationUrl	Zeichenfolge	Netzbetreiber-URL zum Aktivieren von Geräte-eSIM.
userlessSharedAadModeEnabled	Boolean	Gibt an, dass dieses Apple-Gerät für die Unterstützung von Szenarien im "gemeinsam genutzten Gerätemodus" vorgesehen ist. Dies unterscheidet sich vom Szenario "Gemeinsame iPad". Siehe https://docs.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: 2377

{
  "@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,
  "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: 2426

{
  "@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,
  "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
}

DepIOSEnrollmentProfile aktualisieren

Voraussetzungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback