Freigeben über

Schnellstart: Hinzufügen von von Azure verwalteten Domänen für E-Mail-Communication Service

  • Artikel

In diesem Schnellstart erfahren Sie, wie Sie den Azure Managed Domain to Email Communication Service in Azure Communication Services bereitstellen.

Voraussetzungen

Bereitstellen einer von Azure verwalteten Domäne

  1. Öffnen Sie die Seite Übersicht der E-Mail-Kommunikationsdienstressource, die Sie in Erste Schritte mit der E-Mail-Kommunikationsressource erstellt haben.

  2. Erstellen Sie eine Azure Managed Domain mithilfe einer der folgenden Optionen.

    • (Option 1) Klicken Sie unter Kostenlose Azure-Unterdomäne hinzufügen auf die Schaltfläche Hinzufügen. Fahren Sie mit Schritt 3 fort.

    Screenshot: Hinzufügen einer kostenlosen verwalteten Azure-Domäne.

    • (Option 2) Klicken Sie im linken Navigationsbereich auf Domänen bereitstellen.

    Screenshot: Navigationsseite der Bereitstellungsdomänen.

    • Klicken Sie auf der oberen Navigationsleiste auf Domäne hinzufügen.
    • Wählen Sie in der Dropdownliste Azure-Domäne aus.

  3. Warten Sie, bis die Bereitstellung abgeschlossen ist.

    Screenshot der ausgeführten Bereitstellung.

  4. Nachdem die Domäne erstellt wurde, wird eine Listenansicht mit der neuen Domäne angezeigt.

    Screenshot: Liste der bereitgestellten E-Mail-Domänen.

  5. Klicken Sie auf den Namen der bereitgestellten Domäne, um die Seite „Übersicht“ für den Domänenressourcentyp zu öffnen.

    Screenshot: Übersichtsseite für verwaltete Azure-Domäne.

Voraussetzungen

Erstellen einer Domänenressource

Um eine Domänenressource zu erstellen, melden Sie sich bei der Azure CLI an. Sie können sich beim Ausführen des az login-Befehls vom Terminal anmelden und Ihre Anmeldeinformationen bereitstellen. Führen Sie zum Erstellen der Ressource den folgenden Befehl aus:

az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged

Wenn Sie ein bestimmtes Abonnement auswählen möchten, können Sie auch das Flag --subscription und die Abonnement-ID angeben.

az communication email domain create --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --location "Global" --resource-group "<resourceGroup>" --domain-management AzureManaged --subscription "<subscriptionId>"

Sie können Ihre Domänenressource mit den folgenden Optionen konfigurieren:

  • Die Ressourcengruppe
  • Den Namen der E-Mail-Communication Services-Ressource
  • Die Geografie, der die Ressource zugeordnet wird
  • Dem Namen der Domänenressource:
    • Bei Azure-Domänen sollte der Name „AzureManagedDomain“ lauten.
  • Dem Wert der Verwaltungseigenschaft der Domäne.
    • Für Azure-Domänen sollte der Wert „AzureManaged“ lauten.

Im nächsten Schritt können Sie der Domänenressource Tags zuweisen. Tags können verwendet werden, um Domänenressourcen zu strukturieren. Weitere Informationen zu Tags finden Sie in der Dokumentation zum Anwenden von Tags auf Ressourcen.

Verwalten Ihrer Domänenressource

Führen Sie die folgenden Befehle aus, um Tags zu Ihrer Domänenressource hinzuzufügen. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

az communication email domain update --domain-name AzureManagedDomain --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --tags newTag="newVal1" --subscription "<subscriptionId>"

Verwenden Sie den folgenden Befehl, um alle Ihre Domänenressourcen in einem bestimmten E-Mail Communication Service aufzulisten:

az communication email domain list --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>"

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten Domänenressource anzuzeigen:

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

Bereinigen der Domänenressource

Wenn Sie eine Domänenressource bereinigen und entfernen möchten, können Sie löschen, indem Sie den folgenden Befehl ausführen.

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

Hinweis

Das Löschen von Ressourcen ist endgültig, und nach dem Löschen können keine Daten wiederhergestellt werden, auch nicht Event Grid-Filter, Telefonnummern oder andere Daten, die an Ihre Ressource gebunden sind.

Informationen zu anderen Befehlen finden Sie unter Domäne-CLI.

Voraussetzungen

Installieren des SDK

Fügen Sie zunächst die Communication Services-Verwaltungs-SDK in das C#-Projekt ein:

using Azure.ResourceManager.Communication;

Abonnement-ID

Sie müssen die ID Ihres Azure-Abonnements kennen. Diese kann über das Portal abgerufen werden:

  1. Melden Sie sich bei Ihrem Azure-Konto an.
  2. Wählen Sie auf der linken Seitenleiste die Option Abonnements aus.
  3. Wählen Sie das erforderliche Abonnement aus.
  4. Klicken Sie auf „Übersicht“.
  5. Wählen Sie die ID für Ihr Abonnement aus.

In dieser Schnellstartanleitung wird davon ausgegangen, dass Sie die Abonnement-ID in einer Umgebungsvariablen mit dem Namen AZURE_SUBSCRIPTION_ID gespeichert haben.

Authentifizierung

Für die Kommunikation mit einer Domänenressource müssen Sie sich zunächst bei Azure authentifizieren.

Authentifizieren des Clients

Die Standardoption zum Erstellen eines authentifizierten Clients ist die Verwendung von DefaultAzureCredential. Da alle Verwaltungs-APIs denselben Endpunkt durchlaufen, muss nur ein ArmClient auf oberster Ebene erstellt werden, um mit Ressourcen zu interagieren.

Führen Sie den folgenden Code aus, um sich bei Azure zu authentifizieren und einen ArmClient zu erstellen:

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

Interaktion mit Azure-Ressourcen

Nun haben Sie sich authentifiziert.

Für jedes der folgenden Beispiele werden die Domänenressourcen einem vorhandenen E-Mail Communication Service zugewiesen.

Wenn Sie einen E-Mail Communication Service erstellen müssen, können Sie dies über das Azure-Portal tun.

Erstellen einer Domänenressource

Beim Erstellen einer Domänenressource müssen Sie den Namen der Ressourcengruppe, den Namen des E-Mail Communication Service, den Namen der Ressource und DomainManagement angeben.

Hinweis

Die Location -Eigenschaft ist immer global.

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

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "AzureManagedDomain";
CommunicationDomainResourceData data = new CommunicationDomainResourceData(new AzureLocation("Global"))
{
    DomainManagement = DomainManagement.AzureManaged,
};
ArmOperation<CommunicationDomainResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, domainName, data);            
CommunicationDomainResource 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
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Verwalten Ihrer Domänenressourcen

Aktualisieren einer Domänenressource

...
// 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 = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

// invoke the operation
CommunicationDomainResourcePatch patch = new CommunicationDomainResourcePatch()
{
    Tags =
    {
    ["newTag"] = "newVal",
    },
};
ArmOperation<CommunicationDomainResource> lro = await communicationDomainResource.UpdateAsync(WaitUntil.Completed, patch);
CommunicationDomainResource 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
CommunicationDomainResourceData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

Auflisten nach E-Mail Service

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

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation and iterate over the result
await foreach (CommunicationDomainResource 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
    CommunicationDomainResourceData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine($"Succeeded");

Abrufen der Domänenressource

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

// get the collection of this CommunicationDomainResource
CommunicationDomainResourceCollection collection = emailServiceResource.GetCommunicationDomainResources();

// invoke the operation
string domainName = "AzureManagedDomain";
bool result = await collection.ExistsAsync(domainName);

Console.WriteLine($"Succeeded: {result}");

Bereinigen einer Domänenressource

// 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 = "11112222-3333-4444-5555-666677778888";
string resourceGroupName = "MyResourceGroup";
string emailServiceName = "MyEmailServiceResource";
string domainName = "AzureManagedDomain";
ResourceIdentifier communicationDomainResourceId = CommunicationDomainResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, emailServiceName, domainName);
CommunicationDomainResource communicationDomainResource = client.GetCommunicationDomainResource(communicationDomainResourceId);

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

Console.WriteLine($"Succeeded");

Hinweis

Das Löschen von Ressourcen ist endgültig, und nach dem Löschen können keine Daten wiederhergestellt werden, auch nicht Event Grid-Filter, Telefonnummern oder andere Daten, die an Ihre Ressource gebunden sind.

Voraussetzungen

Erstellen einer Domänenressource

Um eine Domänenressource zu erstellen, melden Sie sich mit dem Connect-AzAccount mithilfe des folgenden Befehls bei Ihrem Azure-Konto an und geben Sie Ihre Anmeldeinformationen an.

PS C:\> Connect-AzAccount

Installieren Sie zunächst unbedingt das Azure Communication Services-Modul Az.Communication mithilfe des folgenden Befehls:

PS C:\> Install-Module Az.Communication

Führen Sie den folgenden Befehl aus, um die verwaltete Azure-Domänenressource zu erstellen:

PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name AzureManagedDomain -DomainManagement AzureManaged

Sie können Ihre Domänenressource mit den folgenden Optionen konfigurieren:

  • Die Ressourcengruppe
  • Dem Namen der E-Mail-Communication Services-Ressource.
  • Dem Namen der Domänenressource:
    • Bei Azure-Domänen sollte der Name „AzureManagedDomain“ lauten.
  • Dem Wert der Verwaltungseigenschaft der Domäne.
    • Für Azure-Domänen sollte der Wert „AzureManaged“ lauten.

Im nächsten Schritt können Sie der Domänenressource Tags zuweisen. Tags können verwendet werden, um Domänenressourcen zu strukturieren. Weitere Informationen zu Tags finden Sie in der Dokumentation zum Anwenden von Tags auf Ressourcen.

Verwalten Ihrer Domänenressource

Führen Sie die folgenden Befehle aus, um Tags zu Ihrer Domänenressource hinzuzufügen. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

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

Verwenden Sie den folgenden Befehl, um alle Ihre Domänenressourcen in einem bestimmten E-Mail Communication Service aufzulisten:

PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten Domänenressource aufzulisten:

PS C:\> Get-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Bereinigen einer Domänenressource

Wenn Sie eine Domänenressource bereinigen und entfernen möchten, können Sie Ihre Domänenressource löschen, indem Sie den folgenden Befehl ausführen:

PS C:\> Remove-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1

Hinweis

Das Löschen von Ressourcen ist endgültig, und nach dem Löschen können keine Daten wiederhergestellt werden, auch nicht Event Grid-Filter, Telefonnummern oder andere Daten, die an Ihre Ressource gebunden sind.

Azure Managed Domains im Vergleich zu Custom Domains

Überprüfen Sie vor der Bereitstellung einer Azure Managed Domain die folgende Tabelle, um zu entscheiden, welcher Domänentyp Ihren Anforderungen am besten entspricht.

Von Azure verwaltete Domänen Custom Domains
Vorteile: - Setup ist schnell und einfach
– Keine Domänenüberprüfung erforderlich
 – E-Mails werden von Ihrer eigenen Domäne gesendet
Nachteile: – Absenderdomäne ist nicht personalisiert und kann nicht geändert werden
- Benutzernamen des Absenders können nicht personalisiert werden
- Sehr begrenztes Sendevolumen
- User Engagement Tracking kann nicht aktiviert werden
– Erfordert die Überprüfung von Domänendatensätzen
– Längere Einrichtung für die Überprüfung

Absenderauthentifizierung für von Azure verwaltete Domäne

Azure Communication Services konfiguriert automatisch die erforderlichen E-Mail-Authentifizierungsprotokolle für die E-Mail, wie unter Bewährte Methoden für die E-Mail-Authentifizierung beschrieben.

Ihre E-Mail-Domäne ist jetzt bereit, E-Mails zu senden.

Nächste Schritte