Início rápido: como adicionar e remover Vários Endereços de Remetente aos Serviços de Comunicação do Email.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Um recurso de email dos Serviços de Comunicação do Azure criado e pronto para adicionar os domínios. Consulte Introdução à criação do Recurso de Comunicação por Email.
• Um domínio personalizado com limites de envio acima do padrão provisionados e prontos. Consulte Início Rápido: Como adicionar domínios de email verificados personalizados.

Criar vários nomes de usuário do remetente

Um domínio de email provisionado para enviar email 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 será 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.

1. Abra a página Visão geral do recurso do Serviço de Comunicação por Email que você criou na Introdução à Criação do 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.

   

4. Clique no link Endereços MailFrom na navegação à esquerda para ver o padrão donotreply na lista de endereços MailFrom.

   

5. Clique em Adicionar.

   

6. Insira o Nome de Exibição e o endereço MailFrom. Clique em Salvar.

   

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

   

Seu domínio de email agora está pronto para enviar emails com o endereço MailFrom adicionado.

Removendo vários nomes de usuário do remetente

1. Abra a página de visão geral de Domínios.

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

   

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

   

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

   

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Instalar a CLI do Azure
• Um recurso de email dos Serviços de Comunicação do Azure criado e pronto para adicionar os domínios. Consulte Introdução à criação do Recurso de Comunicação por Email.
• Um domínio personalizado com limites de envio acima do padrão provisionados e prontos. Consulte Início Rápido: Como adicionar domínios de email verificados personalizados.

Criar recurso de nome de usuário do remetente

Para criar um recurso de nome de usuário do remetente, entre na CLI do Azure. Para se conectar, execute o comando az login no terminal e forneça 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 quiser selecionar uma assinatura específica, você também poderá especificar o sinalizador --subscription e fornecer a 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 de serviços de comunicação por email.
• A geografia à qual o recurso será associado.
• O nome do recurso de domínio.
• O nome do nome de usuário do remetente.
• O nome do nome de usuário.

Gerenciar recurso de nome de usuário do remetente

Para adicionar ou atualizar o nome de exibição do recurso de nome de usuário do remetente, execute os comandos a seguir. Você também pode direcionar 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 de 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 em 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 o recurso de nome de usuário do remetente

Se você quiser limpar e remover um recurso de nome de usuário do remetente, poderá excluir o recurso de nome de usuário do remetente executando o comando a seguir.

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

Para obter informações sobre outros comandos, confira CLI de Nome de Usuário do Remetente.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• A versão mais recente do SDK do .NET Core para o seu sistema operacional.
• Obtenha a última versão do SDK de Identidade do .NET.
• Obtenha a última versão do SDK do Gerenciamento do .NET.

Instalando o SDK

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

using Azure.ResourceManager.Communication;

ID da assinatura

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

1. Fazer logon na sua conta do Azure
2. Selecione Assinaturas na barra lateral à esquerda
3. Selecione qualquer assinatura necessária
4. Clique em Visão Geral
5. Selecione a sua ID de Assinatura

Neste guia de início rápido, vamos pressupor 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 de domínio, primeiro você deve se autenticar 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 os recursos, apenas um ArmClient de nível superior deve 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);

Interação com os 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, pode-se usar o portal do Azure.

Criar um recurso de nome de usuário do remetente

Ao criar um recurso de nome de usuário do remetente, você precisa especificar o nome do grupo de recursos, o nome do serviço de comunicação de 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}");

Gerenciar 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");

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
• Instalar o Módulo do PowerShell Azure Az
• Um recurso de email dos Serviços de Comunicação do Azure criado e pronto para adicionar os domínios. Consulte Introdução à criação do Recurso de Comunicação por Email.
• Um domínio personalizado com limites de envio acima do padrão provisionados e prontos. Consulte Início Rápido: Como adicionar domínios de email verificados personalizados.

Criar um recurso de nome de usuário do remetente

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

PS C:\> Connect-AzAccount

Primeiro, instale o módulo Az.Communication dos 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, também poderá especificar o sinalizador --subscription e fornecer a ID da assinatura.

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

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

• O grupo de recursos
• O nome do recurso de serviços de comunicação por email.
• O nome do recurso de domínio.
• O nome do nome de usuário do remetente.
• O nome do nome de usuário.

Gerenciar o recurso de nome de usuário do remetente

Para adicionar ou atualizar o nome de exibição do recurso de nome de usuário do remetente, execute os comandos a seguir. Você também pode direcionar 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 de 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 em 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 nome de usuário do remetente, exclua o recurso de nome de usuário do remetente executando o seguinte comando:

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