Crear depMacOSEnrollmentProfileCreate depMacOSEnrollmentProfile

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 depMacOSEnrollmentProfile .Create a new depMacOSEnrollmentProfile 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.
AplicaciónApplication 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 depMacOSEnrollmentProfile.In the request body, supply a JSON representation for the depMacOSEnrollmentProfile object.

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

PropiedadProperty TipoType DescripciónDescription
idid CadenaString 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 CadenaString Descripción del perfil heredado de enrollmentProfileDescription of the profile Inherited from enrollmentProfile
requiresUserAuthenticationrequiresUserAuthentication BooleanoBoolean Indica si el perfil requiere autenticación de usuario heredada de enrollmentProfileIndicates if the profile requires user authentication Inherited from enrollmentProfile
configurationEndpointUrlconfigurationEndpointUrl CadenaString 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 BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean 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 CadenaString Información del Departamento de soporte técnico heredada de depEnrollmentBaseProfileSupport department information Inherited from depEnrollmentBaseProfile
passCodeDisabledpassCodeDisabled BooleanoBoolean 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 BooleanoBoolean Indica si el perfil es obligatorio y heredado de depEnrollmentBaseProfileIndicates if the profile is mandatory Inherited from depEnrollmentBaseProfile
locationDisabledlocationDisabled BooleanoBoolean 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 CadenaString Número de teléfono de soporte heredado de depEnrollmentBaseProfileSupport phone number Inherited from depEnrollmentBaseProfile
profileRemovalDisabledprofileRemovalDisabled BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean 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 BooleanoBoolean Indica si el panel Configuración del zoom está deshabilitado heredado de depEnrollmentBaseProfileIndicates if zoom setup pane is disabled Inherited from depEnrollmentBaseProfile
siriDisabledsiriDisabled BooleanoBoolean Indica si el panel de configuración de Siri está deshabilitado heredado de depEnrollmentBaseProfileIndicates if siri setup pane is disabled Inherited from depEnrollmentBaseProfile
diagnosticsDisableddiagnosticsDisabled BooleanoBoolean 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 BooleanoBoolean Indica si la pantalla de instalación de displaytone está deshabilitada heredada de depEnrollmentBaseProfileIndicates if displaytone setup screen is disabled Inherited from depEnrollmentBaseProfile
privacyPaneDisabledprivacyPaneDisabled BooleanoBoolean Indica si la pantalla de privacidad está deshabilitada heredada de depEnrollmentBaseProfileIndicates if privacy screen is disabled Inherited from depEnrollmentBaseProfile
screenTimeScreenDisabledscreenTimeScreenDisabled BooleanoBoolean 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 CadenaString Establece un patrón de nombre o literal.Sets a literal or name pattern. Heredado de depEnrollmentBaseProfileInherited from depEnrollmentBaseProfile
configurationWebUrlconfigurationWebUrl BooleanoBoolean Dirección URL para inicio de sesión del Asistente para la instalación heredado de depEnrollmentBaseProfileURL for setup assistant login Inherited from depEnrollmentBaseProfile
registrationDisabledregistrationDisabled BooleanoBoolean Indica si el registro está deshabilitadoIndicates if registration is disabled
fileVaultDisabledfileVaultDisabled BooleanoBoolean Indica si el depósito de archivos está deshabilitadoIndicates if file vault is disabled
iCloudDiagnosticsDisablediCloudDiagnosticsDisabled BooleanoBoolean Indica si la pantalla de análisis de iCloud está deshabilitadaIndicates if iCloud Analytics screen is disabled
iCloudStorageDisablediCloudStorageDisabled BooleanoBoolean Indica si los documentos de iCloud y la pantalla de escritorio están deshabilitadosIndicates if iCloud Documents and Desktop screen is disabled
chooseYourLockScreenDisabledchooseYourLockScreenDisabled BooleanoBoolean Indica si los documentos de iCloud y la pantalla de escritorio están deshabilitadosIndicates if iCloud Documents and Desktop screen is disabled

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto depMacOSEnrollmentProfile en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a depMacOSEnrollmentProfile 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: 1260

{
  "@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",
  "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,
  "registrationDisabled": true,
  "fileVaultDisabled": true,
  "iCloudDiagnosticsDisabled": true,
  "iCloudStorageDisabled": true,
  "chooseYourLockScreenDisabled": 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: 1309

{
  "@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",
  "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,
  "registrationDisabled": true,
  "fileVaultDisabled": true,
  "iCloudDiagnosticsDisabled": true,
  "iCloudStorageDisabled": true,
  "chooseYourLockScreenDisabled": true
}