快速入門：建立和管理電子郵件通訊服務資源

發行項
05/23/2024

藉由布建您的第一個電子郵件通訊服務資源，開始使用電子郵件。透過 Azure 入口網站或使用 .NET 管理用戶端連結庫布建電子郵件通訊服務資源。管理客戶端連結庫和 Azure 入口網站可讓您使用 Azure 的部署和管理服務：Azure Resource Manager 來建立、設定、更新和刪除您的資源和介面。用戶端連結庫中可用的所有函式都可在 Azure 入口網站中使用。

警告

請注意，無法同時建立與 Azure 通訊服務資源相同的資源群組。建立資源時，必須使用已建立的資源群組。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。

使用入口網站建立電子郵件通訊服務資源

開啟 Azure 入口網站以建立新的資源。
搜尋 電子郵件通訊服務。
選取 [電子郵件通訊服務]，然後按下 [建立]
在 [基本] 索引標籤中輸入必要資訊：
- 選取現有的 Azure 訂閱。
- 選取現有的資源群組，或按一下 [新建] 連結來建立新的資源群組。
- 提供資源的有效名稱。
- 選取資源需要可用的區域。
- 選取 [美國] 作為資料位置。
- 若要新增標籤，請按 [下一步：卷標]
- 新增任何名稱/值組。
按一下 [下一步：檢閱 + 建立]。
等候驗證通過，然後按兩下 [ 建立]。
等候部署完成，然後按兩下 [移至資源 ] 以開啟電子郵件通訊服務概觀。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
安裝 Azure CLI

建立電子郵件通訊服務資源

若要建立電子郵件通訊服務資源，請登入 Azure CLI。您可以從終端機執行 az login 命令，並提供您的認證來登入。若要建立資源，請執行下列命令：

az communication email create --name "<EmailServiceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"

如果您想要選取特定的訂用帳戶，您也可以指定 --subscription 旗標並提供訂用帳戶識別碼。

az communication email create --name "<EmailServiceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

您可以使用下列選項來設定電子郵件通訊服務資源：

資源群組
電子郵件通訊服務資源的名稱
資源要產生關聯的地理位置

在下一個步驟中，您可以將標記指派給資源。標記可用來組織您的 Azure 電子郵件資源。如需標記的詳細資訊，請參閱資源標記文件。

管理電子郵件通訊服務資源

若要將標籤新增至電子郵件通訊服務資源，請執行下列命令。您也可以以特定訂用帳戶為目標。

az communication email update --name "<EmailServiceName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

az communication email update --name "<EmailServiceName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

若要列出指定資源群組中的所有電子郵件通訊服務資源，請使用下列命令：

az communication email list --resource-group "<resourceGroup>"

若要顯示指定電子郵件通訊服務資源的所有資訊，請使用下列命令。您也可以以特定訂用帳戶為目標。

az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>"

az communication email show --name "<EmailServiceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

清除資源

如果您要清除並移除電子郵件通訊服務訂用帳戶，您可以刪除資源或資源群組。您可以執行下列命令來刪除電子郵件通訊資源。

az communication email delete --name "<EmailServiceName>" --resource-group "<resourceGroup>"

刪除資源群組也會刪除與其相關聯的任何其他資源。

注意

資源刪除為永久性，而且如果您刪除資源，則無法復原任何資料，包括事件方格篩選、電話號碼或其他繫結至資源的資料。

如需其他命令的相關信息，請參閱電子郵件通訊 CLI。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
適用於您的作業系統的最新版本 .NET Core SDK。
取得最新版本的 .NET 身分識別 SDK。
取得最新版本的 .NET 管理 SDK。

安裝 SDK

首先，將通訊服務管理 SDK 包含在您的 C# 專案中:

using Azure.ResourceManager.Communication;

訂用帳戶識別碼

您必須知道 Azure 訂用帳戶的識別碼。可以從入口網站取得：

登入您的 Azure 帳戶
選取左邊側邊欄的 [訂用帳戶]
選取所需的任何訂用帳戶
按一下 [概觀]
選取訂用帳戶識別碼

在本快速入門中，我們假設您已將訂用帳戶識別碼儲存在名為 AZURE_SUBSCRIPTION_ID 的環境變數中。

驗證

若要與 Azure 通訊服務通訊，您必須先向 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://video2.skills-academy.com/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

與 Azure 資源互動

現在您已通過驗證。

針對下列每個範例，我們會將電子郵件服務資源指派給現有的資源群組。

如果您需要建立資源群組，您可以使用 Azure 入口網站或 Azure Resource Manager SDK 來執行此動作。

建立電子郵件服務資源

建立電子郵件服務資源時，您將指定資源組名和資源名稱。

注意

屬性 Location 一律 global為，而且在公開預覽期間， DataLocation 值必須是 UnitedStates。

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation
string emailServiceName = "MyEmailServiceResource";
EmailServiceResourceData data = new EmailServiceResourceData(new AzureLocation("Global"))
{
    DataLocation = "United States",
};
ArmOperation<EmailServiceResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, emailServiceName, data);
EmailServiceResource 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
EmailServiceResourceData 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 EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

// invoke the operation
EmailServiceResourcePatch patch = new EmailServiceResourcePatch()
{
    Tags =
    {
    ["newTag"] = "newVal",
    },
};
ArmOperation<EmailServiceResource> lro = await emailServiceResource.UpdateAsync(WaitUntil.Completed, patch);
EmailServiceResource 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
EmailServiceResourceData 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this EmailServiceResource
EmailServiceResourceCollection collection = resourceGroupResource.GetEmailServiceResources();

// invoke the operation and iterate over the result
await foreach (EmailServiceResource 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
    EmailServiceResourceData 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 SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation and iterate over the result
await foreach (EmailServiceResource item in subscriptionResource.GetEmailServiceResourcesAsync())
{
    // 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
    EmailServiceResourceData 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 EmailServiceResource created on azure
// for more information of creating EmailServiceResource, please refer to the document of EmailServiceResource
string subscriptionId = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
ResourceIdentifier emailServiceResourceId = EmailServiceResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName);
EmailServiceResource emailServiceResource = client.GetEmailServiceResource(emailServiceResourceId);

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

Console.WriteLine($"Succeeded");

注意

資源刪除為永久性，而且如果您刪除資源，則無法復原任何資料，包括事件方格篩選、電話號碼或其他繫結至資源的資料。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
安裝 Azure Az PowerShell 模組

建立電子郵件通訊服務資源

若要建立電子郵件通訊服務資源，請使用 Connect-AzAccount 下列命令登入您的 Azure 帳戶，並提供您的認證。

PS C:\> Connect-AzAccount

首先，請務必使用下列命令安裝 Azure 通訊服務模組 Az.Communication。

PS C:\> Install-Module Az.Communication

若要建立資源，請執行下列命令：

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates

如果您想要選取特定的訂用帳戶，您也可以指定 --subscription 旗標並提供訂用帳戶識別碼。

PS C:\> New-AzEmailService -ResourceGroupName ContosoResourceProvider1 -Name ContosoEmailServiceResource1 -DataLocation UnitedStates -SubscriptionId SubscriptionID

您可以使用下列選項設定您的通訊服務資源:

資源群組
電子郵件通訊服務資源的名稱
資源要產生關聯的地理位置

在下一個步驟中，您可以將標記指派給資源。標記可用來組織您的 Azure 電子郵件資源。如需標記的詳細資訊，請參閱資源標記文件。

管理電子郵件通訊服務資源

若要將標籤新增至電子郵件通訊服務資源，請執行下列命令。您也可以以特定訂用帳戶為目標。

PS C:\> Update-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

PS C:\> Update-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID

若要列出指定訂用帳戶中的所有電子郵件通訊服務資源，請使用下列命令：

PS C:\> Get-AzEmailService -SubscriptionId SubscriptionID

若要列出指定資源上的所有資訊，請使用下列命令：

PS C:\> Get-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

清除資源

如果您要清除並移除電子郵件通訊服務，您可以執行下列命令來刪除電子郵件通訊資源：

PS C:\> Remove-AzEmailService -Name ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

注意

資源刪除為永久性，而且如果您刪除資源，則無法復原任何資料，包括事件方格篩選、電話號碼或其他繫結至資源的資料。

下一步

熟悉電子郵件用戶端程式庫
瞭解如何在快速入門中傳送具有自定義已驗證網域的電子郵件：如何新增自定義已驗證的電子郵件網域
瞭解如何在快速入門中使用 Azure 受控網域傳送電子郵件：如何將 Azure 受控網域新增至電子郵件

共用方式為

快速入門：建立和管理電子郵件通訊服務資源

必要條件

使用入口網站建立電子郵件通訊服務資源

必要條件

建立電子郵件通訊服務資源

管理電子郵件通訊服務資源

清除資源

必要條件

安裝 SDK

訂用帳戶識別碼

驗證

驗證用戶端

與 Azure 資源互動

建立電子郵件服務資源

管理電子郵件通訊服務資源

更新電子郵件通訊服務資源

依資源群組列出所有電子郵件通訊服務資源

依訂用帳戶列出所有電子郵件通訊服務資源

清除資源

必要條件

建立電子郵件通訊服務資源

管理電子郵件通訊服務資源

清除資源

下一步

意見反應

其他資源

共用方式為

快速入門：建立和管理電子郵件通訊服務資源

必要條件

使用入口網站建立電子郵件通訊服務資源

必要條件

建立電子郵件通訊服務資源

管理電子郵件通訊服務資源

清除資源

必要條件

安裝 SDK

訂用帳戶識別碼

驗證

驗證用戶端

與 Azure 資源互動

建立電子郵件服務資源

管理電子郵件通訊服務資源

更新電子郵件通訊服務資源

依資源群組列出所有電子郵件通訊服務資源

依訂用帳戶列出所有電子郵件通訊服務資源

清除資源

必要條件

建立電子郵件通訊服務資源

管理電子郵件通訊服務資源

清除資源

下一步

相關文章

意見反應

其他資源