Overview

Neste Tutorial demonstraremos como importar contatos externos no Exchange Online via Powershell

Solução

Contatos externos são membros de fora da organização que são exibidos na organização Exchange, possibilitando assim trabalhar com um endereço de email externo sem necessidade de criar uma mailbox para o usuário redirecionada, ao criar um contato externo podemos:

- Adicionar usuários externos a grupos de distribuição.

- Exibir e-mails externo no catalogo de endereço.

- Configurar redirecionamento de mensagens para um email externo.

Sabemos que via Exchange Control Panel é possível criar usuários ou automatizar migração de emails via arquivo CSV, o processo de criação de contatos externos funciona de forma parecida, sendo que todos os passos são executados via Powershell.

Para criarmos os contatos externos, teremos como base 3 passos:

• Criando o arquivo CSV
• Iniciando importação dos contatos
• Opções adicionais

Criando o arquivo CSV...

Este arquivo servirá como base para que o Exchange Online saiba quais e-mails serão importados, para quem já realizou criação de Mailbox via arquivo CSV a linha de raciocínio é a mesma para o arquivo .

Três colunas são obrigatórias para que o arquivo CSV funcione corretamente, elas são:

• ExternalEmailAddress
• Name
• FirstName
• LastName

Vale lembrar que o campo Name pode ser preenchido com a mesma informação do campo ExternalEmailAddress (para facilitar a criação do arquivo).

Com isso nosso arquivo CSV será preenchido da seguinte forma:

ExternalEmailAddress,Name,FirstName,LastName

jonathan.rsantos2@hotmail.com,jonathan.rsantos2@hotmail.com,Jonathan,Santos

Como na imagem abaixo:

Obs: Vale ressaltar que o limitador de coluna necessário para criação do arquivo é a virgula (,) então após criar o arquivo no Excel e salvá-lo como CSV o arquivo deverá estar preenchido como na imagem abaixo:

Observem que substitui o limitador ponto e virgula (;) utilizado ao salvar o arquivo como CSV, por virgula (,) apenas. Feito isso, nosso arquivo está pronto para ser importando no Exchange Online.

Caso precise importar o arquivo com mais informações preenchidas, como por exemplo endereço, cidade, CEP e etc basta adicionar essas informações no arquivo CSV. No link abaixo você encontrará um arquivo TXT pronto para importação, necessitando apenas substituição do espaço por vírgula.

Arquivo de Importação

Iniciando importação dos contatos...

Tendo em mãos o arquivo CSV pronto para ser importado, precisamos executar o Windows Powershell abrindo o diretório onde se encontra o arquivo CSV, como exibido abaixo:

Feito isso, precisamos conectar o Windows Powershell ao Exchange Online, no tutorial http://technet.microsoft.com/pt-br/exchangelabshelp/cc952755 encontramos todo o procedimento necessário para executar o Exchange Online via Powershell.

Após conectarmos ao Exchange Online, utilizaremos o seguinte comando para realizarmos a importação dos contatos:

Import-Csv .\ExternalContacts.csv|%{New-MailContact -Name $_.Name -DisplayName $_.Name -ExternalEmailAddress $_.ExternalEmailAddress -FirstName $_.FirstName -LastName $_.LastName}

A execução do comando será concluída como na imagem abaixo:

Obs:

Caso seu arquivo CSV possua colunas adicionais, lembre se de informar o parâmetro correspondente a coluna que será incluída e também informar a coluna como variável, exemplo:

Ao adicionar a coluna StreetAddress no arquivo CSV será necessário adicionar –StreetAddress e $_. StreetAddress como linha no Powershell, sendo assim o comando será executado da seguinte forma:

Import-Csv .\ExternalContacts.csv|%{New-MailContact -Name $_.Name -DisplayName $_.Name -ExternalEmailAddress $_.ExternalEmailAddress -FirstName $_.FirstName -LastName $_.LastName –StreetAddress $_. StreetAddress }

Agora já podemos acessar o Exchange Control Panel e validarmos se o contato foi criado com sucesso.

Para visualizarmos os contatos externos no ECP abrimos Usuários e Grupos => Contatos Externos, o contato será exibido como na imagem abaixo:

Opções Adicionais...

• Ocultando um contato Externo

Caso você precise ocultar um contato externo para que o mesmo não seja exibido no Global Catalog, basta executar o seguinte comando:

Set-MailContact <Contato Externo> -HiddenFromAddressListsEnabled $true

Para ocultar todos os contatos externos no Exchange Online utilize o seguinte comando:

Get-Contact -ResultSize unlimited -Filter {(RecipientTypeDetails -eq 'MailContact')} | Set-MailContact -HiddenFromAddressListsEnabled $true

A necessidade de ocultar um contato externo no Exchange, pode surgir ao dependermos de contatos apenas para grupos de distribuição e não para exibição no catalogo de endereço.

• Adicionando contato como membro de um grupo de distribuição

Para isso, utilizamos o seguinte comando:

Add-DistributionGroupMember -Identity <Nome do Grupo> -Member <Endereço do contato >

Membro adicionado:

Conclusão

Neste tutorial demonstramos como importar contatos externos no Exchange Online, apesar do recurso não ser nativo no EMC, vimos como executar essa tarefa via Windows Powershell.

Comentários

Neste espaço você pode utilizar sua rede social preferida para adicionar dicas e/ou qualquer informação adicional para ajudar a comunidade relacionado a este Tutorial.