Краткое руководство. Добавление и удаление нескольких Адрес отправителя в службу коммуникации электронной почты
В этом кратком руководстве вы узнаете, как добавлять и удалять несколько адресов отправителя электронной почты в Службы коммуникации Azure.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
- Созданный и готовый к добавлению доменов ресурс электронной почты Службы коммуникации Azure. См. статью "Начало работы с созданием ресурса обмена сообщениями электронной почты".
- Личный домен с более высоким значением по умолчанию, который предоставляется и готов. См . краткое руководство. Добавление пользовательских проверенных доменов электронной почты.
Создание нескольких имен пользователей отправителя
Домен электронной почты, подготовленный для отправки электронной почты, имеет адрес MailFrom по умолчанию, отформатированный как donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net. При настройке личного домена, например notification.azuremails.net, добавлен адрес donotreply@notification.azurecommtest.net MailFrom по умолчанию. Вы можете настроить и добавить дополнительные адреса MailFrom и отображаемые имена FROM для использования значений, которые проще читать.
Примечание.
Имена пользователей отправителя нельзя включить для управляемых доменов Azure независимо от ограничений отправки или пользовательских доменов с ограничениями отправки по умолчанию. Дополнительные сведения см. в разделе "Ограничения служб" для Службы коммуникации Azure.
Откройте страницу "Обзор" ресурса службы коммуникации электронной почты, созданного в разделе "Начало работы с созданием ресурса обмена сообщениями электронной почты".
Щелкните "Подготовка доменов " на левой панели навигации, чтобы просмотреть список подготовленных доменов.
Чтобы открыть страницу обзора домена, щелкните один из подготовленных доменов.
Щелкните ссылку "Адреса MailFrom" в области навигации слева, чтобы просмотреть список адресов MailFrom по умолчанию
donotreply.
Нажмите кнопку Добавить.
Введите отображаемое имя и адрес MailFrom. Нажмите кнопку Сохранить.
Нажмите кнопку "Сохранить ", чтобы просмотреть обновленный список с новым добавленным адресом MailFrom на странице обзора.
Теперь ваш домен электронной почты готов отправлять сообщения электронной почты с добавленным адресом MailFrom.
Удаление нескольких имен пользователей отправителя
Откройте страницу обзора доменов.
Щелкните ссылку "Адреса MailFrom" в области навигации слева, чтобы просмотреть список адресов MailFrom.
Выберите адрес MailFrom, который необходимо удалить, и нажмите кнопку "Удалить".
Просмотрите обновленный список адресов MailFrom на странице обзора.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
- Установка интерфейса командной строки Azure
- Созданный и готовый к добавлению доменов ресурс электронной почты Службы коммуникации Azure. См. статью "Начало работы с созданием ресурса обмена сообщениями электронной почты".
- Личный домен с более высоким значением по умолчанию, который предоставляется и готов. См . краткое руководство. Добавление пользовательских проверенных доменов электронной почты.
Создание ресурса имени пользователя отправителя
Чтобы создать ресурс имени пользователя отправителя, войдите в Azure CLI. Вы можете выполнить команду из az login терминала и предоставить учетные данные. Чтобы создать ресурс, выполните следующую команду:
az communication email domain sender-username create --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --username "contosoNewsAlerts"
Если вы хотите выбрать определенную подписку, можно также указать флаг и указать --subscription идентификатор подписки.
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>"
Вы можете настроить ресурс домена с помощью следующих параметров:
- Группа ресурсов
- Имя ресурса служб коммуникации электронной почты.
- География, с которым будет связан ресурс.
- Имя ресурса домена.
- Имя имени пользователя отправителя.
- Имя имени пользователя.
Примечание.
Имя пользователя отправителя и имя пользователя должны совпадать.
Управление ресурсом имени пользователя отправителя
Чтобы добавить или обновить отображаемое имя для ресурса имени пользователя отправителя, выполните следующие команды. Вы также можете ориентироваться на конкретную подписку.
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>"
Чтобы перечислить все ресурсы имени пользователя отправителя в определенном домене, используйте следующую команду:
az communication email domain sender-username list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com"
Чтобы отобразить все сведения о заданном ресурсе, используйте следующую команду:
az communication email domain sender-username show --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts"
Очистка ресурса имени пользователя отправителя
Если вы хотите очистить и удалить ресурс имени пользователя отправителя, можно удалить ресурс имени пользователя отправителя, выполнив следующую команду.
az communication email domain sender-username delete --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts"
Примечание.
Удаление ресурсов не является постоянным , а данные, включая фильтры сетки событий, номера телефонов или другие данные, привязанные к ресурсу, можно восстановить при удалении ресурса.
Дополнительные сведения о других командах см. в разделе "Имя пользователя отправителя" CLI.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
- Последняя версия пакета SDK для .NET Core для вашей операционной системы.
- Получите последнюю версию пакета SDK для .NET Identity.
- Получите последнюю версию пакета SDK управления .NET.
Установка пакета SDK
Во-первых, добавьте пакет SDK для управления Служб коммуникации в проект C#:
using Azure.ResourceManager.Communication;
ИД подписки
Необходимо знать идентификатор подписки Azure. Его можно получить на портале:
- Войдите в учетную запись Azure.
- Выберите "Подписки" на левой боковой панели.
- Выберите нужную подписку.
- Щелкните "Обзор".
- Выберите "Идентификатор подписки".
В этом кратком руководстве предполагается, что вы сохранили идентификатор подписки в переменной среды AZURE_SUBSCRIPTION_ID.
Проверка подлинности
Чтобы взаимодействовать с ресурсом домена, необходимо сначала пройти проверку подлинности в Azure.
Проверка подлинности клиента
Параметр по умолчанию для создания аутентифицированного клиента — использовать DefaultAzureCredential. Так как все API управления проходят через одну конечную точку, чтобы взаимодействовать с ресурсами, необходимо создать только один интерфейс ArmClient верхнего уровня.
Чтобы выполнить проверку подлинности в Azure и создать ArmClient, выполните следующий код:
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);
Взаимодействие с ресурсами Azure
Теперь, когда вы прошли проверку подлинности.
Для каждого из следующих примеров мы назначим ресурсы имени пользователя отправителя существующему ресурсу домена.
Если вам нужно создать службу связи с электронной почтой, это можно сделать с помощью портал Azure и создания ресурса домена, это можно сделать с помощью портал Azure.
Создание ресурса имени пользователя отправителя
При создании ресурса имени пользователя отправителя необходимо указать имя группы ресурсов, имя службы обмена сообщениями электронной почты, доменное имя и имя ресурса.
// 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}");
Управление ресурсами имени пользователя отправителя
Список по ресурсу домена
// 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");
Получение имени пользователя отправителя
// 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}");
Очистка ресурса имени пользователя отправителя
// 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");
Примечание.
Удаление ресурсов не является постоянным , а данные, включая фильтры сетки событий, номера телефонов или другие данные, привязанные к ресурсу, можно восстановить при удалении ресурса.
Необходимые компоненты
- Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
- Установка модуля Azure Az PowerShell
- Созданный и готовый к добавлению доменов ресурс электронной почты Службы коммуникации Azure. См. статью "Начало работы с созданием ресурса обмена сообщениями электронной почты".
- Личный домен с более высоким значением по умолчанию, который предоставляется и готов. См . краткое руководство. Добавление пользовательских проверенных доменов электронной почты.
Создание ресурса имени пользователя отправителя
Чтобы создать ресурс имени пользователя отправителя, войдите в учетную запись Azure с помощью Connect-AzAccount следующей команды и укажите свои учетные данные.
PS C:\> Connect-AzAccount
Сначала необходимо установить модуль Служб коммуникации Azure Az.Communication с помощью следующей команды.
PS C:\> Install-Module Az.Communication
Выполните следующую команду, чтобы создать имя пользователя отправителя для личного домена:
PS C:\> New-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test
Если вы хотите выбрать определенную подписку, можно также указать флаг --subscription и указать идентификатор подписки.
PS C:\> New-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test -Username test -SubscriptionId SubscriptionID
Вы можете настроить ресурс домена с помощью следующих параметров:
- Группа ресурсов
- Имя ресурса служб коммуникации электронной почты.
- Имя ресурса домена.
- Имя имени пользователя отправителя.
- Имя имени пользователя.
Примечание.
Имя пользователя отправителя и имя пользователя должны совпадать.
Управление ресурсом имени пользователя отправителя
Чтобы добавить или обновить отображаемое имя для ресурса имени пользователя отправителя, выполните следующие команды. Вы также можете ориентироваться на конкретную подписку.
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
Чтобы перечислить все ресурсы имени пользователя отправителя в определенном домене, используйте следующую команду:
PS C:\> Get-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com
Чтобы получить список всех сведений о заданном ресурсе, используйте следующую команду:
PS C:\> Get-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test
Очистка ресурса имени пользователя отправителя
Если вы хотите очистить и удалить ресурс имени пользователя отправителя, вы можете удалить ресурс имени отправителя, выполнив следующую команду:
PS C:\> Remove-AzEmailServiceSenderUsername -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -DomainName contoso.com -SenderUsername test
Примечание.
Удаление ресурсов не является постоянным , а данные, включая фильтры сетки событий, номера телефонов или другие данные, привязанные к ресурсу, можно восстановить при удалении ресурса.
Следующие шаги
Краткое руководство. Создание ресурсов службы коммуникации электронной почты и управление ими
Краткое руководство. Подключение проверенного домена электронной почты
Связанные статьи
- Сведения о клиентской библиотеке для электронной почты
- Узнайте, как отправлять сообщения электронной почты с настраиваемыми проверенными доменами в кратком руководстве. Добавление настраиваемых проверенных доменов электронной почты