Compartir a través de


Inicio rápido: cómo agregar y quitar varias direcciones de remitente a los Servicios de comunicación de correo electrónico

En este inicio rápido, obtendrá información sobre cómo agregar y quitar varias direcciones de remitente de correo electrónico en Azure Communication Services.

Requisitos previos

Creación de varios nombres de usuario de remitente

Un dominio de correo electrónico que se aprovisiona para enviar correo electrónico tiene una dirección MailFrom predeterminada, con el formato donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net. Si configura un dominio personalizado como notification.azuremails.net, entonces la dirección MailFrom predeterminada tiene donotreply@notification.azurecommtest.net agregado. Puede configurar y agregar más direcciones MailFrom y nombres para mostrar FROM para usar valores que son más fáciles de leer.

Nota:

Los nombres de usuario del remitente no se pueden habilitar para dominios administrados de Azure independientemente de los límites de envío o dominios personalizados con límites de envío predeterminados. Para obtener más información, consulte Límites de servicio para Azure Communication Services.

  1. Abra la página Información general del recurso de Email Communication Service que creó en Introducción a la creación de un recurso de comunicación de correo electrónico.

  2. Haga clic en Aprovisionar dominios en el panel de navegación izquierdo para ver la lista de dominios aprovisionados.

  3. Para abrir la página Información general del dominio, haga clic en uno de los dominios aprovisionados.

    Captura de pantalla que muestra el vínculo de dominio en la lista de dominios de correo electrónico aprovisionados.

  4. Haga clic en el vínculo Direcciones MailFrom en el panel de navegación izquierdo para ver el donotreply predeterminado en la lista de direcciones de MailFrom.

    Captura de pantalla que explica cómo enumerar las direcciones MailFrom.

  5. Haga clic en Agregar.

    Captura de pantalla que explica cómo cambiar la dirección del remitente y el nombre para mostrar.

  6. Introduzca el nombre para mostrar y la dirección de MailFrom. Haga clic en Save(Guardar).

    Captura de pantalla que explica cómo guardar la dirección del remitente y el nombre para mostrar.

  7. Haga clic en Guardar para ver la lista actualizada con la dirección MailFrom recién agregada en la página de información general.

    Captura de pantalla que muestra la lista de direcciones Mailfrom con los valores actualizados.

El dominio de correo electrónico ya está listo para enviar correos electrónicos con la dirección MailFrom agregada.

Quitando varios nombres de usuario de remitente

  1. Abra la página de información general de dominios.

  2. Haga clic en el vínculo Direcciones de MailFrom en el panel de navegación izquierdo para ver la lista de direcciones de MailFrom.

    Captura de pantalla en la que se muestran las direcciones MailFrom.

  3. Seleccione la dirección MailFrom que debe quitarse y haga clic en Eliminar.

    Captura de pantalla que muestra la lista de direcciones Mailfrom que deben eliminarse.

  4. Revise la lista actualizada de direcciones MailFrom en la página de información general.

    Captura de pantalla que muestra la lista de direcciones Mailfrom después de la eliminación.

Requisitos previos

Creación de un recurso de nombre de usuario del emisor

Para crear un recurso de nombre de usuario del emisor, inicie sesión en la CLI de Azure. Para iniciar sesión, ejecute el comando az login desde el terminal y proporcione sus credenciales. Para crear el recurso, ejecute el siguiente comando:

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

Si quiere seleccionar una suscripción específica, también puede especificar la marca --subscription y proporcionar el identificador de la suscripción.

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>"

Puede configurar el recurso de dominio con las siguientes opciones:

  • El grupo de recursos
  • El nombre del recurso de Email Communication Services.
  • La geografía a la que se asociará el recurso.
  • El nombre del recurso de dominio.
  • El nombre del nombre de usuario del emisor.
  • El nombre del nombre de usuario.

Nota:

El nombre de usuario y el nombre de usuario del emisor deben ser los mismos.

Administración del recurso de nombre de usuario del emisor

Para agregar o actualizar el nombre para mostrar al recurso de nombre de usuario del emisor, ejecute los siguientes comandos. También puede usar una suscripción específica como destino.

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 enumerar todos los recursos de nombre de usuario del emisor en un dominio determinado, use el siguiente comando:

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

Para mostrar toda la información de un recurso determinado, use el siguiente comando:

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

Limpieza del recurso nombre de usuario del emisor

Si desea limpiar y quitar un recurso de nombre de usuario del emisor, puede eliminarlo ejecutando el comando siguiente.

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

Nota:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Para obtener información sobre otros comandos, consulte CLI del nombre de usuario del emisor.

Requisitos previos

Instalar el SDK

En primer lugar, incluya el SDK de administración de Communication Services en el proyecto de C#:

using Azure.ResourceManager.Communication;

Id. de suscripción

Necesita saber el identificador de su suscripción a Azure. Se puede adquirir en el portal:

  1. Inicie sesión en la cuenta de Azure.
  2. Seleccione Suscripciones en la barra lateral izquierda
  3. Seleccione la suscripción que necesite.
  4. Haga clic en Información general.
  5. Seleccione el identificador de la suscripción.

En este inicio rápido, se supone que ha almacenado el identificador de la suscripción en una variable de entorno denominada AZURE_SUBSCRIPTION_ID.

Autenticación

Para comunicarse con el recurso de dominio, primero debe autenticarse en Azure.

Autenticar el cliente

La opción predeterminada para crear un cliente autenticado es usar DefaultAzureCredential. Dado que todas las API de administración pasan por el mismo punto de conexión, con el fin de interactuar con los recursos, solo se debe crear un ArmClient de nivel superior.

Para autenticarse en Azure y crear un ArmClient, haga lo siguiente:

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

Interacción con los recursos de Azure

Ahora ya está autenticado.

Para cada uno de los ejemplos siguientes, asignaremos los recursos de nombre de usuario de un emisor a un recurso de dominio existente.

Si necesita crear un servicio de comunicación por correo electrónico, puede hacerlo mediante Azure Portal y para crear un recurso de dominio, puede hacerlo mediante Azure Portal.

Creación de un recurso de nombre de usuario del emisor

Al crear un recurso nombre de usuario del emisor, debe especificar el nombre del grupo de recursos, el nombre del servicio de comunicación por correo electrónico, el nombre de dominio y el nombre del 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}");

Administración de recursos de nombre de usuario del emisor

Enumeración por recurso de dominio

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

Obtención del nombre de usuario del emisor

// 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}");

Limpieza de un recurso de nombre de usuario del emisor

// 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:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Requisitos previos

Creación de un recurso de nombre de usuario del emisor

Para crear un recurso nombre de usuario del emisor, inicie sesión en su cuenta de Azure mediante el Connect-AzAccount con el comando siguiente y proporcione sus credenciales.

PS C:\> Connect-AzAccount

En primer lugar, asegúrese de instalar el módulo Azure Communication Services Az.Communication con el siguiente comando.

PS C:\> Install-Module Az.Communication

Ejecute el comando siguiente para crear el nombre de usuario del emisor para el dominio personalizado:

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

Si quiere seleccionar una suscripción específica, también puede especificar la marca --subscription y proporcionar el identificador de la suscripción.

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

Puede configurar el recurso de dominio con las siguientes opciones:

  • El grupo de recursos
  • El nombre del recurso de Email Communication Services.
  • El nombre del recurso de dominio.
  • El nombre del nombre de usuario del emisor.
  • El nombre del nombre de usuario.

Nota:

El nombre de usuario y el nombre de usuario del emisor deben ser los mismos.

Administración del recurso de nombre de usuario del emisor

Para agregar o actualizar el nombre para mostrar al recurso de nombre de usuario del emisor, ejecute los siguientes comandos. También puede usar una suscripción específica como destino.

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 enumerar todos los recursos de nombre de usuario del emisor en un dominio determinado, use el siguiente comando:

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

Para mostrar toda la información de un recurso determinado, use el siguiente comando:

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

Limpieza de un recurso de nombre de usuario del emisor

Si desea limpiar y quitar un recurso de nombre de usuario del emisor, puede eliminarlo ejecutando el comando siguiente:

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

Nota:

La eliminación de recursos es permanente y, si los elimina, no se puede recuperar ningún dato, filtros de Event Grid, números de teléfono u otros datos vinculados a los recursos incluidos.

Pasos siguientes