快速入門: 如何將多個傳送者地址新增至電子郵件通訊服務和從中移除。
在本快速入門中，您將瞭解如何在 Azure 通訊服務 中新增和移除多個電子郵件位址。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- 已建立並準備好新增網域 Azure 通訊服務 電子郵件資源。 請參閱 開始使用建立電子郵件通訊資源。
- 布建和就緒高於預設傳送限制的自定義網域。 請參閱 快速入門：如何新增自定義已驗證的電子郵件網域。
建立多個寄件者用戶名稱
布建傳送電子郵件的電子郵件網域具有預設的 MailFrom 位址，格式為 donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net。 如果您設定自定義網域，例如 notification.azuremails.net，則預設的 MailFrom 位址已 donotreply@notification.azurecommtest.net 新增。 您可以設定及新增更多 MailFrom 位址和 FROM 顯示名稱，以使用更容易閱讀的值。
注意
無論傳送限制或具有預設傳送限制的自定義網域，都無法為 Azure 受控網域啟用寄件者用戶名稱。 如需詳細資訊，請參閱 Azure 通訊服務的服務限制。
開啟您在開始使用建立電子郵件通訊資源中建立的電子郵件通訊服務資源 [概觀] 頁面。
按兩下 左側導覽面板中的 [布建網域 ]，以查看已布建網域的清單。
若要開啟 [網域概觀] 頁面，請按兩下其中一個已布建網域。
![顯示已布建電子郵件網域清單中 [網域] 連結的螢幕快照。](media/email-provisioned-domains.png)
按兩下左側導覽中的 [MailFrom 位址] 連結，以查看MailFrom 位址清單中的預設值
donotreply。
按一下新增。
輸入 [顯示名稱] 和 [MailFrom 地址]。 按一下 [檔案] 。
按兩下 [ 儲存 ] 以查看在概觀頁面中新增MailFrom位址的更新清單。
![顯示已布建電子郵件網域清單中 [網域] 連結的螢幕快照。](media/email-provisioned-domains-expanded.png#lightbox)
您的電子郵件網域現在已準備好使用新增的 MailFrom 地址來傳送電子郵件。
移除多個傳送者使用者名稱
開啟 [網域概觀] 頁面。
按兩下 左側導覽中的 [MailFrom 位址 ] 連結，以查看MailFrom 位址清單。
選取需要移除的郵件地址，然後按下 [ 刪除]。
在概觀頁面中檢閱 MailFrom 位址的更新清單。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- 安裝 Azure CLI
- 已建立並準備好新增網域 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>"
您可以使用下列選項來設定網域資源：
- 資源群組
- 電子郵件通訊服務資源的名稱。
- 資源將相關聯的地理位置。
- 網域資源的名稱。
- 寄件者用戶名稱。
- Username 的名稱。
注意
寄件者用戶名稱和使用者名稱應該相同。
管理寄件者用戶名稱資源
若要將顯示名稱新增或更新至您的寄件者使用者名稱資源，請執行下列命令。 您也可以以特定訂用帳戶為目標。
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 帳戶。 免費建立帳戶。
- 適用於您的作業系統的最新版本 .NET Core SDK。
- 取得最新版本的 .NET 身分識別 SDK。
- 取得最新版本的 .NET 管理 SDK。
安裝 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 通訊服務 電子郵件資源已建立並準備好新增網域。 請參閱 開始使用建立電子郵件通訊資源。
- 布建和就緒高於預設傳送限制的自定義網域。 請參閱 快速入門：如何新增自定義已驗證的電子郵件網域。
建立寄件者用戶名稱資源
若要建立寄件者使用者名稱資源，請使用 Connect-AzAccount 下列命令登入您的 Azure 帳戶，並提供您的認證。
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
您可以使用下列選項來設定網域資源：
- 資源群組
- 電子郵件通訊服務資源的名稱。
- 網域資源的名稱。
- 寄件者用戶名稱。
- Username 的名稱。
注意
寄件者用戶名稱和使用者名稱應該相同。
管理寄件者用戶名稱資源
若要將顯示名稱新增或更新至您的寄件者使用者名稱資源，請執行下列命令。 您也可以以特定訂用帳戶為目標。
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
注意
資源刪除為永久性，而且如果您刪除資源，則無法復原任何資料，包括事件方格篩選、電話號碼或其他繫結至資源的資料。
下一步
相關文章
- 熟悉電子郵件用戶端程式庫
- 瞭解如何在快速入門中 傳送具有自定義已驗證網域的電子郵件：如何新增自定義已驗證的電子郵件網域