Criar depIOSEnrollmentProfile
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto depIOSEnrollmentProfile .
Essa API está disponível nas seguintes implantações nacionais de nuvem.
| Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
| Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
|---|---|
| Delegado (conta corporativa ou de estudante) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Aplicativo | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
Cabeçalhos de solicitação
| Cabeçalho | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON para o objeto depIOSEnrollmentProfile.
A tabela a seguir mostra as propriedades necessárias ao criar o depIOSEnrollmentProfile.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O GUID para o objeto Herdado do registroProfile |
| displayName | Cadeia de caracteres | Nome do perfil Herdado de registroProfile |
| description | Cadeia de caracteres | Descrição do perfil Herdado do registroProfile |
| requiresUserAuthentication | Booliano | Indica se o perfil requer autenticação de usuário Herdada do registroProfile |
| configurationEndpointUrl | Cadeia de caracteres | Url de ponto de extremidade de configuração a ser usada para Registro Herdado de registroProfile |
| enableAuthenticationViaCompanyPortal | Booliano | Indica a autenticação com o Assistente de Instalação da Apple em vez de Portal da Empresa. Herdado do registroProfile |
| requireCompanyPortalOnSetupAssistantEnrolledDevices | Booliano | Indica que Portal da Empresa é necessário na instalação assistente dispositivos registrados Herdados do registroProfile |
| isDefault | Booliano | Indica se esse é o perfil padrão Herdado de depEnrollmentBaseProfile |
| supervisedModeEnabled | Booliano | Modo supervisionado, True para habilitar, false caso contrário. Consulte https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune para obter informações adicionais. Herdado de depEnrollmentBaseProfile |
| supportDepartment | Cadeia de caracteres | Suporte a informações do departamento herdadas de depEnrollmentBaseProfile |
| isMandatory | Booliano | Indica se o perfil é herdado obrigatório do depEnrollmentBaseProfile |
| locationDisabled | Booliano | Indica se o painel de configuração do serviço de localização está desabilitado Herdado do depEnrollmentBaseProfile |
| supportPhoneNumber | Cadeia de caracteres | Suporte ao número de telefone Herdado de depEnrollmentBaseProfile |
| profileRemovalDisabled | Booliano | Indica se a opção de remoção de perfil está desabilitada Herdada de depEnrollmentBaseProfile |
| restoreBlocked | Booliano | Indica se o painel Restaurar configuração está bloqueado Herdado do depEnrollmentBaseProfile |
| appleIdDisabled | Booliano | Indica se o painel de configuração de ID da Apple está desabilitado Herdado do depEnrollmentBaseProfile |
| termsAndConditionsDisabled | Booliano | Indica se o painel de configuração 'Termos e Condições' está desabilitado Herdado do depEnrollmentBaseProfile |
| touchIdDisabled | Booliano | Indica se o painel de configuração de id de toque está desabilitado Herdado de depEnrollmentBaseProfile |
| applePayDisabled | Booliano | Indica se o painel de configuração de pagamento da Apple está desabilitado Herdado do depEnrollmentBaseProfile |
| siriDisabled | Booliano | Indica se o painel de instalação da Siri está desabilitado Herdado do depEnrollmentBaseProfile |
| diagnosticsDisabled | Booliano | Indica se diagnóstico painel de configuração está desabilitado Herdado do depEnrollmentBaseProfile |
| displayToneSetupDisabled | Booliano | Indica se a tela de configuração do displaytone está desabilitada Herdada de depEnrollmentBaseProfile |
| privacyPaneDisabled | Booliano | Indica se a tela de privacidade está desabilitada Herdada de depEnrollmentBaseProfile |
| screenTimeScreenDisabled | Booliano | Indica se a configuração de tempo limite de tela está desabilitada Herdada do depEnrollmentBaseProfile |
| deviceNameTemplate | Cadeia de caracteres | Define um padrão literal ou de nome. Herdado de depEnrollmentBaseProfile |
| configurationWebUrl | Booliano | URL para configuração assistente logon Herdado do depEnrollmentBaseProfile |
| enableedSkipKeys | String collection | enableedSkipKeys contém todas as chaves de salto habilitadas como cadeias de caracteres Herdadas de depEnrollmentBaseProfile |
| enrollmentTimeAzureAdGroupIds | Coleção de GUIDs | EnrollmentTimeAzureAdGroupIds contém a lista de Ids de tempo de registro do Grupo do Azure a serem associadas ao perfil Herdado de depEnrollmentBaseProfile |
| waitForDeviceConfiguredConfirmation | Booliano | Indica se o dispositivo precisará aguardar a confirmação configurada Herdada de depEnrollmentBaseProfile |
| iTunesPairingMode | iTunesPairingMode | Indica o modo de emparelhamento do iTunes. Os valores possíveis são: disallow, allow, requiresCertificate. |
| managementCertificates | coleção managementCertificateWithThumbprint | Certificados de gerenciamento do Apple Configurator |
| restoreFromAndroidDisabled | Booliano | Indica se a restauração do Android está desabilitada |
| awaitDeviceConfiguredConfirmation | Booliano | Indica se o dispositivo precisará aguardar a confirmação configurada |
| sharedIPadMaximumUserCount | Int32 | Isso especifica o número máximo de usuários que podem usar um iPad compartilhado. Aplicável somente no modo iPad compartilhado. |
| enableSharedIPad | Booliano | Isso indica se o dispositivo deve ser registrado em um modo que habilita vários cenários de usuário. Aplicável somente em iPads compartilhados. |
| companyPortalVppTokenId | Cadeia de caracteres | Se definido, indica qual token Vpp deve ser usado para implantar o licenciamento do dispositivo Portal da Empresa w/. 'enableAuthenticationViaCompanyPortal' deve ser definido para que essa propriedade seja definida. |
| enableSingleAppEnrollmentMode | Booliano | Informa ao dispositivo para habilitar o modo de aplicativo único e aplicar o bloqueio de aplicativo durante o registro. O padrão é false. 'enableAuthenticationViaCompanyPortal' e 'companyPortalVppTokenId' devem ser definidos para que essa propriedade seja definida. |
| homeButtonScreenDisabled | Booliano | Indica se a tela de confidencialidade do botão inicial está desabilitada |
| iMessageAndFaceTimeScreenDisabled | Booliano | Indica se a tela iMessage e FaceTime está desabilitada |
| onBoardingScreenDisabled | Booliano | Indica se a tela de instalação de integração está desabilitada |
| simSetupScreenDisabled | Booliano | Indica se a tela SIMSetup está desabilitada |
| softwareUpdateScreenDisabled | Booliano | Indica se a tela de atualização de sofware obrigatória está desabilitada |
| watchMigrationScreenDisabled | Booliano | Indica se a tela de migração watch está desabilitada |
| appearanceScreenDisabled | Booliano | Indica se a tela do Apperance está desabilitada |
| expressLanguageScreenDisabled | Booliano | Indica se a tela do Express Language está desabilitada |
| preferredLanguageScreenDisabled | Booliano | Indica se a tela de idioma preferencial está desabilitada |
| deviceToDeviceMigrationDisabled | Booliano | Indica se a migração de dispositivo para dispositivo está desabilitada |
| welcomeScreenDisabled | Booliano | Indica se a tela weclome está desabilitada |
| passCodeDisabled | Booliano | Indica se o painel de configuração de senha está desabilitado |
| zoomDisabled | Booliano | Indica se o painel de instalação de zoom está desabilitado |
| restoreCompletedScreenDisabled | Booliano | Indica se a tela weclome está desabilitada |
| updateCompleteScreenDisabled | Booliano | Indica se a tela weclome está desabilitada |
| forceTemporarySession | Booliano | Indica se as sessões temporárias estão habilitadas |
| temporarySessionTimeoutInSeconds | Int32 | Indica o tempo limite da sessão temporária |
| userSessionTimeoutInSeconds | Int32 | Indica o tempo limite da sessão temporária |
| senhaLockGracePeriodInSeconds | Int32 | Indica o tempo limite antes que a tela bloqueada exija que o usuário insira a senha do dispositivo para desbloqueá-lo |
| carrierActivationUrl | Cadeia de caracteres | URL da operadora para ativar o dispositivo eSIM. |
| userlessSharedAadModeEnabled | Booliano | Indica que esse dispositivo apple é designado para dar suporte a cenários de "modo de dispositivo compartilhado". Isso é distinto do cenário de "iPad compartilhado". Confira https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios| |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto depIOSEnrollmentProfile no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
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
}
Resposta
Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.
HTTP/1.1 201 Created
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
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de