Freigeben über

Schnellstart: Hinzufügen und Entfernen mehrerer Absenderadressen zu Communication Service für E-Mail

  • Artikel

In diesem Schnellstart erfahren Sie, wie Sie mehrere Absenderadressen in Azure Communication Services hinzufügen und entfernen, um E-Mails zu senden.

Voraussetzungen

Erstellen mehrerer Absenderbenutzernamen

Eine E-Mail-Domäne, die zum Senden von E-Mails bereitgestellt wird, weist eine standardmäßige MailFrom-Adresse auf, die als donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.netformatiert ist. Wenn Sie eine benutzerdefinierte Domäne wie notification.azuremails.net konfigurieren, wurde die Standardmäßige MailFrom-Adresse donotreply@notification.azurecommtest.net hinzugefügt. Sie können weitere MailFrom-Adressen und FROM-Anzeigenamen konfigurieren und hinzufügen, um werte zu verwenden, die einfacher zu lesen sind.

Hinweis

Absenderbenutzernamen können nicht für Azure Managed Domains aktiviert werden, unabhängig von Sendegrenzwerten oder benutzerdefinierten Domänen mit standardmäßigen Sendegrenzwerten. Weitere Informationen finden Sie unter Dienstgrenzwerte für Azure Communication Services.

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

  2. Klicken Sie im linken Navigationsbereich auf Bereitstellungsdomänen, um die Liste der bereitgestellten Domänen anzuzeigen.

  3. Um die Seite „Domänenübersicht“ zu öffnen, klicken Sie auf eine der bereitgestellten Domänen.

    Screenshot des Domänenlinks in der Liste der bereitgestellten E-Mail-Domänen.

  4. Klicken Sie im linken Navigationsbereich auf den Link MailFrom-Adressen, um die Standard-donotreply in der MailFrom-Adressen-Liste anzuzeigen.

    Screenshot, der zeigt, wie Sie MailFrom-Adressen auflisten.

  5. Klicken Sie auf Hinzufügen.

    Screenshot, der zeigt, wie Sie Absenderadressen und Anzeigenamen ändern.

  6. Geben Sie die Anzeigenamen und die MailFrom-Adresse ein. Klicke auf Speichern.

    Screenshot, der zeigt, wie Sie Absenderadressen und Anzeigenamen speichern.

  7. Klicken Sie auf Speichern, um die aktualisierte Liste mit neu hinzugefügter MailFrom-Adresse auf der Übersichtsseite anzuzeigen.

    Screenshot der Liste „Mailfrom-Adressen“ mit aktualisierten Werten.

Ihre E-Mail-Domäne ist jetzt bereit, E-Mails mit hinzugefügter MailFrom-Adresse zu senden.

Entfernen mehrerer Absenderbenutzernamen

  1. Öffnen Sie die Seite „Domänenübersicht“.

  2. Klicken Sie in der linken Navigationsleiste auf den MailFrom-Adressen-Link, um die Liste der MailFrom-Adressen anzuzeigen.

    Screenshot der MailFrom-Adressen.

  3. Wählen Sie die MailFrom-Adresse aus, die entfernt werden muss, und klicken Sie auf Löschen.

    Screenshot der Liste „MailFrom-Adressen“ mit der Schaltfläche „Löschen“.

  4. Überprüfen Sie die aktualisierte Liste der MailFrom-Adressen auf der Übersichtsseite.

    Screenshot der Liste „MailFrom-Adressen“ nach dem Löschvorgang.

Voraussetzungen

Erstellen einer Absenderbenutzernamen-Ressource

Um eine Absenderbenutzernamen-Ressource zu erstellen, melden Sie sich bei 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 sender-username create --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --username "contosoNewsAlerts"

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 sender-username create --email-service-name "<EmailServiceName>" --resource-group "<resourceGroup>" --domain-name "contoso.com" --sender-username "contosoNewsAlerts" --username "contosoNewsAlerts" --subscription "<subscriptionId>"

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

  • Die Ressourcengruppe
  • Dem Namen der E-Mail-Communication Services-Ressource.
  • Der Geografie, der die Ressource zugeordnet wird.
  • Dem Namen der Domänenressource.
  • Der Name des Absenderbenutzernamens.
  • Der Name des Benutzernamens.

Hinweis

Der Absenderbenutzername und der Benutzername sollten identisch sein.

Verwalten der Absenderbenutzernamen-Ressource

Führen Sie zum Hinzufügen oder Aktualisieren des Anzeigenamens zur Absenderbenutzernamen-Ressource die folgenden Befehle aus. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

Verwenden Sie den folgenden Befehl, um alle Ihre Absenderbenutzernamen-Ressourcen in einer bestimmten Domäne auflisten zu können:

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

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten Ressource anzuzeigen:

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

Bereinigen einer Absenderbenutzernamen-Ressource

Wenn Sie eine Absenderbenutzernamen-Ressource bereinigen und entfernen möchten, können Sie Ihre Absenderbenutzername-Ressource löschen, indem Sie den folgenden Befehl ausführen.

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

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 Absenderbenutzername-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 Absenderbenutzernamen-Ressourcen einer vorhandenen Domänenressource zugewiesen.

Wenn Sie einen E-Mail-Kommunikationsdienst erstellen müssen, können Sie dazu das Azure-Portal verwenden. Eine Domänenressource können Sie auch im Azure-Portal erstellen.

Erstellen einer Absenderbenutzernamen-Ressource

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

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

Verwalten von Absenderbenutzernamen-Ressourcen

Nach Domänenressource auflisten

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

Absenderbenutzername abrufen

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

Bereinigen einer Absenderbenutzernamen-Ressource

// 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 = "11112222-3333-4444-5555-666677778888";
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");

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 Absenderbenutzernamen-Ressource

Um eine Absenderbenutzernamen-Ressource 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 den Absenderbenutzernamen für benutzerdefinierte Domäne zu erstellen:

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

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

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

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.
  • Der Name des Absenderbenutzernamens.
  • Der Name des Benutzernamens.

Hinweis

Der Absenderbenutzername und der Benutzername sollten identisch sein.

Verwalten der Absenderbenutzernamen-Ressource

Führen Sie zum Hinzufügen oder Aktualisieren des Anzeigenamens zur Absenderbenutzernamen-Ressource die folgenden Befehle aus. Sie können auch ein bestimmtes Abonnement als Ziel haben.

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

Verwenden Sie den folgenden Befehl, um alle Ihre Absenderbenutzernamen-Ressourcen in einer bestimmten Domäne auflisten zu können:

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

Verwenden Sie den folgenden Befehl, um alle Informationen zu einer bestimmten Ressource aufzulisten:

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

Bereinigen einer Absenderbenutzernamen-Ressource

Wenn Sie eine Absenderbenutzernamen-Ressource bereinigen und entfernen möchten, können Sie Ihre Absenderbenutzername-Ressource löschen, indem Sie den folgenden Befehl ausführen.

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

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.

Nächste Schritte