Partilhar via

Guia de início rápido: como adicionar e remover vários endereços de remetente para o serviço de comunicação por e-mail

  • Artigo

Neste início rápido, você aprenderá sobre como adicionar e remover vários endereços de remetente de email nos Serviços de Comunicação do Azure.

Pré-requisitos

Criar vários nomes de usuário de remetente

Um domínio de email provisionado para enviar e-mails tem um endereço MailFrom padrão, formatado como donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net. Se você configurar um domínio personalizado, como notification.azuremails.net, o endereço MailFrom padrão foi donotreply@notification.azurecommtest.net adicionado. Você pode configurar e adicionar mais endereços MailFrom e nomes de exibição FROM para usar valores mais fáceis de ler.

Nota

Os nomes de usuário do remetente não podem ser habilitados para Domínios Gerenciados do Azure, independentemente dos limites de envio ou domínios personalizados com limites de envio padrão. Para obter mais informações, consulte Limites de serviço para os Serviços de Comunicação do Azure.

  1. Abra a página Visão geral do recurso Serviço de Comunicação por Email que você criou em Introdução à criação de recurso de comunicação por email.

  2. Clique em Provisionar domínios no painel de navegação esquerdo para ver a lista de domínios provisionados.

  3. Para abrir a página Visão Geral do Domínio, clique em um dos domínios provisionados.

    Captura de tela que mostra o link Domínio na lista de domínios de e-mail provisionados.

  4. Clique no link MailFrom Addresses na navegação à esquerda para ver o padrão donotreply na lista MailFrom addresses.

    Captura de tela que explica como listar endereços MailFrom.

  5. Clique em Adicionar.

    Captura de tela que explica como alterar o endereço MailFrom e o nome para exibição.

  6. Insira o Nome para exibição e o endereço MailFrom. Clique em Guardar.

    Captura de tela que explica como salvar o endereço MailFrom e o nome para exibição.

  7. Clique em Salvar para ver a lista atualizada com o endereço MailFrom recém-adicionado na página de visão geral.

    Captura de tela que mostra a lista de endereços Mailfrom com valores atualizados.

Seu domínio de e-mail agora está pronto para enviar e-mails com o endereço MailFrom adicionado.

Removendo vários nomes de usuário de remetente

  1. Abra a página Visão geral de domínios.

  2. Clique no link MailFrom addresses na navegação à esquerda para ver a lista MailFrom endereços.

    Captura de tela que mostra os endereços MailFrom.

  3. Selecione o endereço MailFrom que precisa ser removido e clique em Excluir.

    Captura de tela que mostra a lista de endereços MailFrom com exclusão.

  4. Revise a lista atualizada de endereços MailFrom na página de visão geral.

    Captura de tela que mostra a lista de endereços MailFrom após a exclusão.

Pré-requisitos

Criar recurso de nome de usuário do remetente

Para criar um recurso Nome de Usuário do Remetente, entre na CLI do Azure. Você pode entrar executando o az login comando do terminal e fornecendo suas credenciais. Para criar o recurso, execute o seguinte comando:

az communication email domain sender-username create --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --username "contosoNewsAlerts"

Se você quiser selecionar uma assinatura específica, você também pode especificar o --subscription sinalizador e fornecer o ID da assinatura.

az communication email domain sender-username create --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --username "contosoNewsAlerts" --subscription "<subscriptionId>"

Você pode configurar seu recurso de domínio com as seguintes opções:

  • O grupo de recursos
  • O nome do recurso Serviços de Comunicação por Email.
  • A geografia à qual o recurso estará associado.
  • O nome do recurso de domínio.
  • O nome do usuário do remetente.
  • O nome do nome de usuário.

Nota

O nome de usuário do remetente e o nome de usuário devem ser os mesmos.

Gerenciar seu recurso Nome de usuário do remetente

Para adicionar ou atualizar o nome para exibição ao recurso Nome de usuário do remetente, execute os comandos a seguir. Você também pode segmentar uma assinatura específica.

az communication email domain sender-username update --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --display-name "Contoso News Alerts"

az communication email domain sender-username update --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --display-name "Contoso News Alerts" --subscription "<subscriptionId>"

Para listar todos os recursos do Nome de Usuário do Remetente em um determinado Domínio, use o seguinte comando:

az communication email domain sender-username list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com"

Para mostrar todas as informações sobre um determinado recurso, use o seguinte comando:

az communication email domain sender-username show --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts"

Limpar recurso Nome de usuário do remetente

Se você quiser limpar e remover um recurso de nome de usuário de remetente, você pode excluir seu recurso de nome de usuário de remetente executando o seguinte comando.

az communication email domain sender-username delete --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts"

Nota

A exclusão de recursos é permanente e nenhum dado, incluindo filtros de grade de eventos, números de telefone ou outros dados vinculados ao seu recurso, pode ser recuperado se você excluir o recurso.

Para obter informações sobre outros comandos, consulte Sender Username CLI.

Pré-requisitos

Instalando o SDK

Primeiro, inclua o SDK de Gerenciamento de Serviços de Comunicação em seu projeto C#:

using Azure.ResourceManager.Communication;

ID de Subscrição

Você precisa saber a ID da sua assinatura do Azure. Isto pode ser adquirido no portal:

  1. Inicie sessão na sua conta do Azure
  2. Selecione Subscrições na barra lateral esquerda
  3. Selecione a assinatura necessária
  4. Clique em Visão geral
  5. Selecione o seu ID de Subscrição

Neste início rápido, assumiremos que você armazenou a ID da assinatura em uma variável de ambiente chamada AZURE_SUBSCRIPTION_ID.

Autenticação

Para se comunicar com o recurso Domínio, você deve primeiro autenticar-se no Azure.

Autenticar o cliente

A opção padrão para criar um cliente autenticado é usar DefaultAzureCredential. Como todas as APIs de gerenciamento passam pelo mesmo ponto de extremidade, para interagir com recursos, apenas um ArmClient de nível superior precisa ser criado.

Para autenticar no Azure e criar um ArmClient, faça o seguinte código:

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Resources;
...
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

Interagindo com recursos do Azure

Agora que você está autenticado.

Para cada um dos exemplos a seguir, atribuiremos nossos recursos de Nome de Usuário do Remetente a um recurso de Domínio existente.

Se você precisar criar um Serviço de Comunicação por Email, poderá fazê-lo usando o portal do Azure e, para criar um recurso de Domínio, poderá fazê-lo usando o portal do Azure.

Criar um recurso Nome de usuário do remetente

Ao criar um recurso Nome de usuário do remetente, você precisa especificar o nome do grupo de recursos, o nome do serviço de comunicação por email, o nome do domínio e o nome do recurso.

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "contosoResourceGroup";
string emailServiceName = "contosoEmailService";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// get the collection of this SenderUsernameResource
SenderUsernameResourceCollection collection = communicationDomainResource.GetSenderUsernameResources();

// invoke the operation
string senderUsername = "contosoNewsAlerts";
SenderUsernameResourceData data = new SenderUsernameResourceData()
{
    Username = "contosoNewsAlerts",
    DisplayName = "Contoso News Alerts",
};
ArmOperation<SenderUsernameResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, senderUsername, data);
SenderUsernameResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SenderUsernameResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Gerenciando recursos de nome de usuário do remetente

Listar por recurso de domínio

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "contosoResourceGroup";
string emailServiceName = "contosoEmailService";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// get the collection of this SenderUsernameResource
SenderUsernameResourceCollection collection = communicationDomainResource.GetSenderUsernameResources();

// invoke the operation and iterate over the result
await foreach (SenderUsernameResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    SenderUsernameResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Obter nome de usuário do remetente

// this example assumes you already have this CommunicationDomainResource created on azure
// for more information of creating CommunicationDomainResource, please refer to the document of CommunicationDomainResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "contosoResourceGroup";
string emailServiceName = "contosoEmailService";
string domainName = "contoso.com";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// get the collection of this SenderUsernameResource
SenderUsernameResourceCollection collection = communicationDomainResource.GetSenderUsernameResources();

// invoke the operation
string senderUsername = "contosoNewsAlerts";
bool result = await collection.ExistsAsync(senderUsername);

Console.WriteLine($"Succeeded: {result}");

Limpar um recurso de nome de usuário do remetente

// this example assumes you already have this SenderUsernameResource created on azure
// for more information of creating SenderUsernameResource, please refer to the document of SenderUsernameResource
string subscriptionId = "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "contoso.com";
string senderUsername = "contosoNewsAlerts";
ResourceIdentifier senderUsernameResourceId = SenderUsernameResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName, senderUsername);
SenderUsernameResource senderUsernameResource = client.GetSenderUsernameResource(senderUsernameResourceId);

// invoke the operation
await senderUsernameResource.DeleteAsync(WaitUntil.Completed);

Console.WriteLine($"Succeeded");

Nota

A exclusão de recursos é permanente e nenhum dado, incluindo filtros de grade de eventos, números de telefone ou outros dados vinculados ao seu recurso, pode ser recuperado se você excluir o recurso.

Pré-requisitos

Criar um recurso Nome de usuário do remetente

Para criar um recurso Nome de Usuário do Remetente, entre em sua conta do Azure usando o Connect-AzAccount comando a seguir e forneça suas credenciais.

PS C:\> Connect-AzAccount

Primeiro, certifique-se de instalar o módulo Az.Communication Serviços de Comunicação do Azure usando o comando a seguir.

PS C:\> Install-Module Az.Communication

Execute o seguinte comando para criar o nome de usuário do remetente para o domínio personalizado:

PS C:\> New-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test

Se você quiser selecionar uma assinatura específica, você também pode especificar o sinalizador --subscription e fornecer o ID da assinatura.

PS C:\> New-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test -SubscriptionId SubscriptionID

Você pode configurar seu recurso de domínio com as seguintes opções:

  • O grupo de recursos
  • O nome do recurso Serviços de Comunicação por Email.
  • O nome do recurso de domínio.
  • O nome do usuário do remetente.
  • O nome do nome de usuário.

Nota

O nome de usuário do remetente e o nome de usuário devem ser os mesmos.

Gerenciar seu recurso de nome de usuário do remetente

Para adicionar ou atualizar o nome para exibição ao recurso Nome de usuário do remetente, execute os comandos a seguir. Você também pode segmentar uma assinatura específica.

PS C:\> Update-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test -DisplayName testdisplayname

PS C:\> Update-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test -DisplayName testdisplayname -SubscriptionId SubscriptionID

Para listar todos os recursos do Nome de Usuário do Remetente em um determinado Domínio, use o seguinte comando:

PS C:\> Get-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com

Para listar todas as informações sobre um determinado recurso, use o seguinte comando:

PS C:\> Get-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test

Limpar um recurso de nome de usuário do remetente

Se você quiser limpar e remover um recurso de nome de usuário de remetente, você pode excluir seu recurso de nome de usuário de remetente executando o seguinte comando:

PS C:\> Remove-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test

Nota

A exclusão de recursos é permanente e nenhum dado, incluindo filtros de grade de eventos, números de telefone ou outros dados vinculados ao seu recurso, pode ser recuperado se você excluir o recurso.

Próximos passos