Crear depIOSEnrollmentProfileCreate depIOSEnrollmentProfile

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante: Las API de Microsoft Graph en la versión/beta están sujetas a cambios; no se admite el uso de producción.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Cree un nuevo objeto depIOSEnrollmentProfile .Create a new depIOSEnrollmentProfile object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
ApplicationApplication DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All

Solicitud HTTPHTTP Request

POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto depIOSEnrollmentProfile.In the request body, supply a JSON representation for the depIOSEnrollmentProfile object.

En la tabla siguiente se muestran las propiedades necesarias para crear el depIOSEnrollmentProfile.The following table shows the properties that are required when you create the depIOSEnrollmentProfile.

PropiedadProperty TipoType DescripciónDescription
idid StringString El GUID para el objeto heredado de enrollmentProfileThe GUID for the object Inherited from enrollmentProfile
displayNamedisplayName CadenaString Nombre del perfil heredado de enrollmentProfileName of the profile Inherited from enrollmentProfile
descriptiondescription StringString Descripción del perfil heredado de enrollmentProfileDescription of the profile Inherited from enrollmentProfile
requiresUserAuthenticationrequiresUserAuthentication BooleanBoolean Indica si el perfil requiere autenticación de usuario heredada de enrollmentProfileIndicates if the profile requires user authentication Inherited from enrollmentProfile
configurationEndpointUrlconfigurationEndpointUrl StringString URL del punto de conexión de configuración que se usará para la inscripción heredada de enrollmentProfileConfiguration endpoint url to use for Enrollment Inherited from enrollmentProfile
enableAuthenticationViaCompanyPortalenableAuthenticationViaCompanyPortal BooleanBoolean Indica que se autentique con el Asistente de configuración de Apple en lugar del portal de empresa.Indicates to authenticate with Apple Setup Assistant instead of Company Portal. Heredado de enrollmentProfileInherited from enrollmentProfile
requireCompanyPortalOnSetupAssistantEnrolledDevicesrequireCompanyPortalOnSetupAssistantEnrolledDevices BooleanBoolean Indica que el portal de la compañía es necesario en los dispositivos inscritos del Asistente para la configuración heredados de enrollmentProfileIndicates that Company Portal is required on setup assistant enrolled devices Inherited from enrollmentProfile
isDefaultisDefault BooleanoBoolean Indica si este es el perfil predeterminado heredado de depEnrollmentBaseProfileIndicates if this is the default profile Inherited from depEnrollmentBaseProfile
supervisedModeEnabledsupervisedModeEnabled BooleanBoolean Modo supervisado; es true para habilitar; de lo contrario, false.Supervised mode, True to enable, false otherwise. Consulte https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune para obtener más información.See https://docs.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune for additional information. Heredado de depEnrollmentBaseProfileInherited from depEnrollmentBaseProfile
supportDepartmentsupportDepartment StringString Información del Departamento de soporte técnico heredada de depEnrollmentBaseProfileSupport department information Inherited from depEnrollmentBaseProfile
passCodeDisabledpassCodeDisabled BooleanBoolean Indica si el panel Configuración de códigos de acceso se ha deshabilitado heredado de depEnrollmentBaseProfileIndicates if Passcode setup pane is disabled Inherited from depEnrollmentBaseProfile
isMandatoryisMandatory BooleanBoolean Indica si el perfil es obligatorio y heredado de depEnrollmentBaseProfileIndicates if the profile is mandatory Inherited from depEnrollmentBaseProfile
locationDisabledlocationDisabled BooleanBoolean Indica si el panel Configuración del servicio de ubicación está deshabilitado heredado de depEnrollmentBaseProfileIndicates if Location service setup pane is disabled Inherited from depEnrollmentBaseProfile
supportPhoneNumbersupportPhoneNumber StringString Número de teléfono de soporte heredado de depEnrollmentBaseProfileSupport phone number Inherited from depEnrollmentBaseProfile
profileRemovalDisabledprofileRemovalDisabled BooleanBoolean Indica si la opción de eliminación de perfiles está deshabilitada heredada de depEnrollmentBaseProfileIndicates if the profile removal option is disabled Inherited from depEnrollmentBaseProfile
restoreBlockedrestoreBlocked BooleanBoolean Indica si el panel Configuración de la restauración está bloqueado y heredado de depEnrollmentBaseProfileIndicates if Restore setup pane is blocked Inherited from depEnrollmentBaseProfile
appleIdDisabledappleIdDisabled BooleanBoolean Indica si el panel Configuración de ID de Apple está deshabilitado heredado de depEnrollmentBaseProfileIndicates if Apple id setup pane is disabled Inherited from depEnrollmentBaseProfile
termsAndConditionsDisabledtermsAndConditionsDisabled BooleanBoolean Indica si se ha deshabilitado el panel de configuración ' términos y condiciones ' heredado de depEnrollmentBaseProfileIndicates if 'Terms and Conditions' setup pane is disabled Inherited from depEnrollmentBaseProfile
touchIdDisabledtouchIdDisabled BooleanBoolean Indica si el panel de configuración de ID de toque está deshabilitado heredado de depEnrollmentBaseProfileIndicates if touch id setup pane is disabled Inherited from depEnrollmentBaseProfile
applePayDisabledapplePayDisabled BooleanBoolean Indica si el panel Configuración de pago de Apple está deshabilitado heredado de depEnrollmentBaseProfileIndicates if Apple pay setup pane is disabled Inherited from depEnrollmentBaseProfile
zoomDisabledzoomDisabled BooleanBoolean Indica si el panel Configuración del zoom está deshabilitado heredado de depEnrollmentBaseProfileIndicates if zoom setup pane is disabled Inherited from depEnrollmentBaseProfile
siriDisabledsiriDisabled BooleanBoolean Indica si el panel de configuración de Siri está deshabilitado heredado de depEnrollmentBaseProfileIndicates if siri setup pane is disabled Inherited from depEnrollmentBaseProfile
diagnosticsDisableddiagnosticsDisabled BooleanBoolean Indica si el panel Configuración de diagnósticos se ha deshabilitado heredado de depEnrollmentBaseProfileIndicates if diagnostics setup pane is disabled Inherited from depEnrollmentBaseProfile
displayToneSetupDisableddisplayToneSetupDisabled BooleanBoolean Indica si la pantalla de instalación de displaytone está deshabilitada heredada de depEnrollmentBaseProfileIndicates if displaytone setup screen is disabled Inherited from depEnrollmentBaseProfile
privacyPaneDisabledprivacyPaneDisabled BooleanBoolean Indica si la pantalla de privacidad está deshabilitada heredada de depEnrollmentBaseProfileIndicates if privacy screen is disabled Inherited from depEnrollmentBaseProfile
screenTimeScreenDisabledscreenTimeScreenDisabled BooleanBoolean Indica si la configuración de tiempo de espera de pantalla se ha deshabilitado heredado de depEnrollmentBaseProfileIndicates if screen timeout setup is disabled Inherited from depEnrollmentBaseProfile
deviceNameTemplatedeviceNameTemplate StringString Establece un patrón de nombre o literal.Sets a literal or name pattern. Heredado de depEnrollmentBaseProfileInherited from depEnrollmentBaseProfile
configurationWebUrlconfigurationWebUrl BooleanBoolean Dirección URL para inicio de sesión del Asistente para la instalación heredado de depEnrollmentBaseProfileURL for setup assistant login Inherited from depEnrollmentBaseProfile
iTunesPairingModeiTunesPairingMode iTunesPairingModeiTunesPairingMode Indica el modo de emparejamiento de iTunes.Indicates the iTunes pairing mode. Los valores posibles son: disallow, allow y requiresCertificate.Possible values are: disallow, allow, requiresCertificate.
managementCertificatesmanagementCertificates colección managementCertificateWithThumbprintmanagementCertificateWithThumbprint collection Certificados de administración para Apple ConfiguratorManagement certificates for Apple Configurator
restoreFromAndroidDisabledrestoreFromAndroidDisabled BooleanBoolean Indica si la restauración de Android está deshabilitadaIndicates if Restore from Android is disabled
awaitDeviceConfiguredConfirmationawaitDeviceConfiguredConfirmation BooleanBoolean Indica si el dispositivo tendrá que esperar la confirmación configuradaIndicates if the device will need to wait for configured confirmation
sharedIPadMaximumUserCountsharedIPadMaximumUserCount Int32Int32 Especifica el número máximo de usuarios que pueden usar un iPad compartido.This specifies the maximum number of users that can use a shared iPad. Solo es aplicable en el modo iPad compartido.Only applicable in shared iPad mode.
enableSharedIPadenableSharedIPad BooleanBoolean Esto indica si el dispositivo se va a inscribir en un modo que habilita escenarios de varios usuarios.This indicates whether the device is to be enrolled in a mode which enables multi user scenarios. Solo se aplica en iPad compartido.Only applicable in shared iPads.
companyPortalVppTokenIdcompanyPortalVppTokenId StringString Si se establece, indica el token de PCV que se debe usar para implementar el portal de empresa con licencias de dispositivo.If set, indicates which Vpp token should be used to deploy the Company Portal w/ device licensing. debe establecerse ' enableAuthenticationViaCompanyPortal ' para que se pueda establecer esta propiedad.'enableAuthenticationViaCompanyPortal' must be set in order for this property to be set.
enableSingleAppEnrollmentModeenableSingleAppEnrollmentMode BooleanBoolean Indica al dispositivo que habilite el modo de aplicación única y que aplique el bloqueo de la aplicación durante la inscripción.Tells the device to enable single app mode and apply app-lock during enrollment. El valor predeterminado es false.Default is false. debe establecerse "enableAuthenticationViaCompanyPortal" y "companyPortalVppTokenId" para que se pueda establecer esta propiedad.'enableAuthenticationViaCompanyPortal' and 'companyPortalVppTokenId' must be set for this property to be set.
homeButtonScreenDisabledhomeButtonScreenDisabled BooleanBoolean Indica si la pantalla de distinción de botones en Inicio está deshabilitadaIndicates if home button sensitivity screen is disabled
iMessageAndFaceTimeScreenDisablediMessageAndFaceTimeScreenDisabled BooleanBoolean Indica si la pantalla iMessage y FaceTime está deshabilitadaIndicates if iMessage and FaceTime screen is disabled
onBoardingScreenDisabledonBoardingScreenDisabled BooleanBoolean Indica si la pantalla de instalación de la incorporación está deshabilitadaIndicates if onboarding setup screen is disabled
simSetupScreenDisabledsimSetupScreenDisabled BooleanBoolean Indica si la pantalla SIMSetup está deshabilitadaIndicates if the SIMSetup screen is disabled
softwareUpdateScreenDisabledsoftwareUpdateScreenDisabled BooleanBoolean Indica si la pantalla de actualización del personal obligatorio está deshabilitadaIndicates if the mandatory sofware update screen is disabled
watchMigrationScreenDisabledwatchMigrationScreenDisabled BooleanBoolean Indica si la pantalla migración de inspección está deshabilitadaIndicates if the watch migration screen is disabled
appearanceScreenDisabledappearanceScreenDisabled BooleanBoolean Indica si la pantalla apperance está deshabilitadaIndicates if Apperance screen is disabled
expressLanguageScreenDisabledexpressLanguageScreenDisabled BooleanBoolean Indica si la pantalla de idioma exprés está deshabilitadaIndicates if Express Language screen is disabled
preferredLanguageScreenDisabledpreferredLanguageScreenDisabled BooleanBoolean Indica si la pantalla de idioma preferido está deshabilitadaIndicates if Preferred language screen is disabled
deviceToDeviceMigrationDisableddeviceToDeviceMigrationDisabled BooleanBoolean Indica si la migración de dispositivo a dispositivo está deshabilitadaIndicates if Device To Device Migration is disabled
welcomeScreenDisabledwelcomeScreenDisabled BooleanBoolean Indica si la pantalla weclome está deshabilitadaIndicates if Weclome screen is disabled

RespuestaResponse

Si se ejecuta correctamente, este método 201 Created devuelve un código de respuesta y un objeto depIOSEnrollmentProfile en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a depIOSEnrollmentProfile object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

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

{
  "@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",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": 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
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 2073

{
  "@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",
  "passCodeDisabled": true,
  "isMandatory": true,
  "locationDisabled": true,
  "supportPhoneNumber": "Support Phone Number value",
  "profileRemovalDisabled": true,
  "restoreBlocked": true,
  "appleIdDisabled": true,
  "termsAndConditionsDisabled": true,
  "touchIdDisabled": true,
  "applePayDisabled": true,
  "zoomDisabled": 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
}