Atualizar 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.
Atualize as propriedades de um 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
PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile
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 200 OK
código de resposta e um objeto depIOSEnrollmentProfile atualizado no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
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
}
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 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
}
Comentários
https://aka.ms/ContentUserFeedback.
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, consulteEnviar e exibir comentários de