Compartilhar via

EMAIL2 Configuration Service Provider

  • Artigo

Windows Mobile SupportedWindows Embedded CE Not Supported

9/19/2008

Operadores móveis e OEMs podem usar o provedor de serviços de configuração EMAIL2 para configurar contas email protocolo SMTP (SMTP) para dispositivos execução Windows Mobile 2003 e posterior.

Quando você configurar um aplicativo remoção ou configuração rolo-voltar, o EMAIL2 Provedor de serviços de configuração passa a solicitação para Configuration Manager, que manipula a transação externamente. Quando você remover um aplicativo MAPI, as contas que foram criadas com ele são excluídos. Se você tentar criar uma nova conta email, e você for malsucedido, a nova conta é automaticamente excluído. Se você tentar editar uma conta existente e você está malsucedido, o original é configuração automaticamente rolado voltar (Restaurado).

Observação

Todas as mensagens e outras propriedades que pode ter armazenados de transporte (por exemplo, Short Message Service [SMS], [POP] Post Office Protocol ou protocolo SMTP [SMTP]), são perdidas.

Você também pode usar este provedor de serviços de configuração para habilitar Secure Sockets Layer (SSL) para de entrada e de saída servidores email. Para fazer isso, use um sem nome marca: < Parm nome = "8128000B" valor = "1" > Para a de entrada servidor, e < Parm nome = "812C000B" valor = "1" > Para a de saída servidor. Para obter mais informações, consulte Enabling SSL Example.

Para obter mais informações sobre SSL, consulte SSL Support.

A seguinte tabela mostra as configurações usar como padrão. A função de segurança usar como padrão mapeia para cada subnó a menos que permissão específica é concedida para o subnó.

Permissões

Leitura/gravação

Funções permitidas para consulta e configuração atualização

Gerenciador

AuthenticatedUser
Bb737579.security(pt-br,MSDN.10).gifSecurity Note:
Dados de configuração não serão criptografados quando enviada através de ar (OTA).Esteja ciente de que este é um risco de segurança em potencial quando enviar confidencial dados de configuração, such as senhas.

O seguinte diagrama ilustra a esquema EMAIL2 Configuration Service Provider usada em OMA DM.

Bb737579.41c43f55-2034-4066-a122-ded33efa7981(pt-br,MSDN.10).gif

O seguinte diagrama ilustra a esquema EMAIL2 Configuration Service Provider usada em OMA Client Provisioning.

Bb737579.2665f17d-69b3-480f-b891-097378a2a561(pt-br,MSDN.10).gif

Características

  • EMAIL2
    A característica Encapsulating para todos os outros email serviço configuração elementos (agrupa todos os serviços email no documento de configuração).

  • < GUID >
    Define uma conta específica email. Este é um identificador exclusivo (GUID) que você deve gerar para cada nova conta.

    Observação

    Ao gerenciar sobre o Outlook Mobile Access DM, certifique-se de utilizar sempre um exclusivo GUID.A configuração com uma conta que tenha o mesmo GUID como um já existente exclui a conta existente e não cria a nova conta.

    Observação

    {} Colchetes são exigido em torno de GUID na EMAIL2 Configuration Service Provider.Na configuração do cliente Outlook Mobile Access, você pode tipo os colchetes, de exemplo, < característica tipo = " {C556E16F-56 C C 4-4edb-9 64-D9469EE1FBE0} " / >.Para o Outlook Mobile Access DM, você deve usar os valores ASCII de 0x7B e 0x7D, respectivamente.De exemplo, se o GUID é " C556E16F-56 C C 4-4edb-9 64-D9469EE1FBE0 " Que tipo de < destino > < LocURI > ./Vendor/MSFT/EMAIL2/0x7BC556E16F-56C4-4edb-9C64-D9469EE1FBE0x7D

  • NAMEDPROPS
    Especifica que você está informando atributos nome elemento parâmetro como fora do padrão nomeado propriedades. Usado para GRUPO juntos parâmetros que são identificados por uma combinação de MAPI propriedade nomes e tipos.
  • TAGPROPS
    Especifica que você está informando atributos nome elemento parâmetro como fora do padrão marca propriedades. Usado para GRUPO juntos parâmetros que são identificados por marcas propriedade MAPI.

Parâmetros

  • 8128000B
    Usado para habilitar a de entrada servidor para SSL. Um valor de 1 indica que SSL é habilitado; um zero (0) indica que ele não está habilitado. Para obter um exemplo, consulte Enabling SSL Example.
  • 812C000B
    Usado para habilitar a de saída servidor para SSL. Um valor de 1 indica que SSL é habilitado; um zero (0) indica que ele não está habilitado. Para obter um exemplo, consulte Enabling SSL Example.
  • AUTHNAME
    [Necessários] O nome usado para autorizar o usuário para uma conta específica email (also Known as Nome de usuário logon).
  • AUTHREQUIRED
    [Opcional] Especifica se o de saída servidor requer autenticação (1 para TRUE) e 0 para FALSE.
  • AUTHSECRET
    [Opcional] Senha do usuário a. A mesma senha é usada para autenticação SMTP.
  • CONNECTIONID
    [Opcional] Conexão de rede GUID. O CONNECTIONID parâmetro deve aparecer imediatamente abaixo de < GUID > característica. Se você não incluir o CONNECTIONID parâmetro, o dispositivo móvel irá tentar localizar o melhor conexão automaticamente.
  • Domínio
    [Opcional] Nome de usuário domínio.
  • DWNDAY
    [Opcional] A quantidade de email para baixar. Este é o número de dias ' Pena, indo voltar no passado. Use um valor de-1 (ou 4294967295) para especificar que você desejar para baixar todas as mensagens que estão atualmente no servidor.
  • FORMAT
    [Opcional] Especifica que formato usar para fazer o download e redigir novas mensagens email (1 para Plain Text) e 2 para HTML. O usar como padrão é HTML.
  • INSERVER
    [Necessários] O nome do de entrada do serviço de mensagens servidor email.
  • KEEPMAX
    [Opcional] Especifica o tamanho máximo (em KB) para anexos mensagem para ser baixado. Anexos que são maior permanecerá sobre o servidor, mas a mensagem próprio ainda será baixada. Use um valor de 0 para especificar que você não têm desejar quaisquer anexos mensagem. Use um valor de-1 (ou 4294967295) para especificar que você desejar todos os anexos mensagem, não importa como grande.

  • LINGER
    [Opcional] Freqüência que Microsoft Outlook usa para executar agendada envia/recebe. A freqüência é especificada como o período de tempo entre as atualizações, em minutos.

    Observação

    Se um valor não for fornecido para LINGER, os padrões configuração sincronizar conexão automática a cada 15 minutos.Você deve definir o parâmetro LINGER como 0 para nunca conectar automaticamente.

  • Nome
    [Opcional] O nome exibir associado com conta email de usuário.
  • OUTSERVER
    [Necessários] O nome do de saída serviço de mensagens servidor email.
  • REPLYADDR
    [Necessários] Responder endereço de email do usuário (geralmente o mesmo que endereço de email do usuário).
  • RETRIEVE
    [Opcional] Especifica o tamanho máximo (em bytes) para mensagens recuperadas da de entrada servidor email. Mensagens além esse tamanho ainda serão recuperadas, mas serão truncadas. Use um valor de 0 para especificar que você apenas desejar para baixar cabeçalhos. Use um valor de-1 (ou 4294967295) para especificar que você desejar para baixar as mensagens completas.

  • SERVICENAME
    [Necessários] O nome do serviço de email para criar ou editar, máximo 32 caracteres.

    Observação

    O provedor de serviços de configuração Email2 não suporte o OMA DM Substituir Comando nos parâmetros SERVICENAME e SERVICETYPE.Para substituir o nome conta email ou tipo de serviço de conta, você deve excluir conta de email existentes e, em seguida, criar um novo nome.

  • SERVICETYPE
    [Necessários] O tipo de serviço email para criar ou editar (such as IMAP4 ou POP3).

    Observação

    O provedor de serviços de configuração Email2 não suporte o OMA DM Substituir Comando nos parâmetros SERVICENAME e SERVICETYPE.Para substituir o nome conta email ou tipo de serviço de conta, você deve excluir conta de email existentes e, em seguida, criar um novo nome.

  • SMTPALTAUTHNAME
    [Opcional] Nome de exibição associado com alternativo do usuário conta email SMTP; válido somente se SMTPALTENABLED é true.
  • SMTPALTDOMAIN
    [Opcional] Nome de usuário domínio para o alternativo conta SMTP; válido somente se SMTPALTENABLED é true.
  • SMTPALTENABLED
    [Opcional] Um Boolean valor que indica que um alternativo servidor SMTP está habilitado.
  • SMTPALTPASSWORD
    [Opcional] Senha para o alternativo conta SMTP; válido somente se SMTPALTENABLED é true.

Elementos personalizados Microsoft

A seguinte tabela mostra o personalizado Microsoft elementos que este provedor de serviços de configuração oferece suporte para configuração do cliente Outlook Mobile Access.

Elementos Disponível

Parm-consulta

Sim

noparm

Não

nocharacteristic

Sim

característica-consulta

Sim

Recursiva: Sim

Raiz nível do Configuration Service Provider: Não

Use esses elementos para compilar padrão configuração OMA Client Provisioning XML. Para obter informações sobre elementos específicos, consulte MSPROV DTD Elements. Para obter exemplos gerais de como usar o personalizado Microsoft elementos, consulte OMA Client Provisioning XML File Examples.

Para obter informações sobre OMA Client Provisioning, consulte OMA Client Provisioning Files.

Remarks

Se você desejar configurar um dispositivo Windows Mobile powered so that ele pode usar Server ActiveSync Sincronizar todos os tipos de objetos servidor Microsoft Exchange (rather than email apenas), use o Sync Configuration Service Provider.

Acesso a este provedor de serviços de configuração é determinado pelas funções de segurança. Porque os OEMs e operadores Mobile podem seletivamente acessar desautorizar, pergunte sobre a disponibilidade deste Configuration Service Provider. Para obter mais informações sobre funções, consulte Funções de Segurança e direitos de acesso padrão para provedores de serviço de configuração.

Para o Outlook Mobile Access DM, o provedor de serviços de configuração EMAIL2 manipula o comando substituir de maneira diferente da maioria dos outros provedores de serviço de configuração. Para o provedor de serviços de configuração EMAIL2, Configuration Manager implicitamente adiciona a parte ausente o nó a ser substituído ou qualquer segmento no caminho do nó se ele for deixado fora na < LocURI > </LocURI > bloco. Há separar os parâmetros definidos para a de saída servidor logon credenciais. As regras de uso para essas credenciais é o seguinte:

  • Continuar a usar a de entrada credenciais logon servidor (AUTHNAME, AUTHSECRET, domínio), a menos que o de saída credenciais servidor estão definidas.
  • Se alguns, mas não todos as de saída servidor credenciais parâmetros estão presentes e o provedor de serviços de configuração EMAIL2 será considerado em erro.
  • Não é possível consulta para conta Detalhes, a menos que você já saiba a conta GUID (atualmente, há nenhuma maneira para executar um de alto nível consulta para conta GUIDs).

See Also

Tasks

EMAIL2 Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Powered Devices

Other Resources

EMAIL2 Configuration Service Provider Examples for OMA DM
EMAIL2 Configuration Service Provider Mapping to OMA DM E-mail XML