Delen via

Quickstart: Meerdere Adres van verzender es toevoegen aan en verwijderen van e-mailcommunicatieservice

  • Artikel

In deze quickstart leert u hoe u meerdere e-mailadressen van afzenders toevoegt en verwijdert in Azure Communication Services.

Vereisten

Meerdere gebruikersnamen voor afzenders maken

Een e-maildomein dat is ingericht voor het verzenden van e-mail, heeft een standaard MailFrom-adres, opgemaakt als donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net. Als u een aangepast domein configureert, zoals notification.azuremails.net, is het standaard-MailFrom-adres donotreply@notification.azurecommtest.net toegevoegd. U kunt meer MailFrom-adressen en FROM-weergavenamen configureren en toevoegen om waarden te gebruiken die gemakkelijker leesbaar zijn.

Notitie

Gebruikersnamen van afzenders kunnen niet worden ingeschakeld voor door Azure beheerde domeinen, ongeacht de verzendlimieten of aangepaste domeinen met standaardlimieten voor verzenden. Zie Servicelimieten voor Azure Communication Services voor meer informatie.

  1. Open de overzichtspagina van de resource e-mailcommunicatieservice die u hebt gemaakt in Aan de slag met het maken van een resource voor e-mailcommunicatie.

  2. Klik op Domeinen inrichten in het linkernavigatievenster om de lijst met ingerichte domeinen weer te geven.

  3. Als u de pagina Domeinoverzicht wilt openen, klikt u op een van de ingerichte domeinen.

    Schermopname van de domeinkoppeling in de lijst met ingerichte e-maildomeinen.

  4. Klik op de koppeling MailFrom Addresses in de linkernavigatiebalk om de standaard donotreply in de lijst Met e-mailadressen weer te geven.

    Schermopname waarin wordt uitgelegd hoe u een lijst met MailFrom-adressen kunt weergeven.

  5. Klik op Toevoegen.

    Schermopname waarin wordt uitgelegd hoe u Het e-mailadres en de weergavenaam wijzigt.

  6. Voer de weergavenaam en het e-mailadres in. Klik op Opslaan.

    Schermopname waarin wordt uitgelegd hoe u MailFrom-adres en weergavenaam opslaat.

  7. Klik op Opslaan om de bijgewerkte lijst weer te geven met het zojuist toegevoegde MailFrom-adres op de overzichtspagina.

    Schermopname van de lijst met e-mailadressen met bijgewerkte waarden.

Uw e-maildomein is nu klaar om e-mailberichten te verzenden met het E-mailadres toegevoegd.

Meerdere gebruikersnamen van afzenders verwijderen

  1. Open de overzichtspagina Domeinen.

  2. Klik op de koppeling MailFrom-adressen in de linkernavigatiebalk om de lijst Met e-mailadressen weer te geven.

    Schermopname van MailFrom-adressen.

  3. Selecteer het MailFrom-adres dat moet worden verwijderd en klik op Verwijderen.

    Schermopname van de lijst Met e-mailadressen met verwijdering.

  4. Bekijk de bijgewerkte lijst met MailFrom-adressen op de overzichtspagina.

    Schermopname van de lijst Met e-mailadressen na verwijdering.

Vereisten

Gebruikersnaamresource voor afzender maken

Als u een resource voor de gebruikersnaam van de afzender wilt maken, meldt u zich aan bij Azure CLI. U kunt zich aanmelden bij het uitvoeren van de az login opdracht vanuit de terminal en uw referenties opgeven. Voer de volgende opdracht uit om de resource te maken:

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

Als u een specifiek abonnement wilt selecteren, kunt u ook de --subscription vlag opgeven en de abonnements-id opgeven.

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

U kunt uw domeinresource configureren met de volgende opties:

  • De resourcegroep
  • De naam van de Resource e-mailcommunicatieservices.
  • De geografie waarmee de resource wordt gekoppeld.
  • De naam van de domeinresource.
  • De naam van de gebruikersnaam van de afzender.
  • De naam van de gebruikersnaam.

Notitie

De gebruikersnaam en gebruikersnaam van de afzender moeten hetzelfde zijn.

De gebruikersnaamresource van de afzender beheren

Voer de volgende opdrachten uit om de weergavenaam toe te voegen of bij te werken aan de gebruikersnaam van de afzender. U kunt ook een specifiek abonnement instellen.

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

Als u alle resources voor de gebruikersnaam van de afzender in een bepaald domein wilt weergeven, gebruikt u de volgende opdracht:

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

Als u alle informatie over een bepaalde resource wilt weergeven, gebruikt u de volgende opdracht:

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

Resource afzendergebruikersnaam opschonen

Als u een bron voor de gebruikersnaam van de afzender wilt opschonen en verwijderen, kunt u de gebruikersnaamresource van de afzender verwijderen door de volgende opdracht uit te voeren.

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

Notitie

Het verwijderen van resources is permanent en er kunnen geen gegevens, waaronder event grid-filters, telefoonnummers of andere gegevens die aan uw resource zijn gekoppeld, worden hersteld als u de resource verwijdert.

Zie De CLI voor de gebruikersnaam van afzender voor meer informatie over andere opdrachten.

Vereisten

De SDK installeren

Neem eerst de Communication Services Management SDK op in uw C#-project:

using Azure.ResourceManager.Communication;

Abonnements-id

U moet de id van uw Azure-abonnement weten. U vindt deze in het portaal:

  1. Meld u aan bij uw Azure-account
  2. Selecteer Abonnementen in de zijbalk aan de linkerzijde
  3. Selecteer het abonnement dat u nodig hebt
  4. Klik op Overzicht
  5. Selecteer uw Abonnements-ID

In deze quickstart wordt ervan uitgegaan dat u de abonnements-ID hebt opgeslagen in een omgevingsvariabele met de naam AZURE_SUBSCRIPTION_ID.

Verificatie

Als u wilt communiceren met domeinresources, moet u zich eerst verifiëren bij Azure.

De client verifiëren

De standaardoptie voor het maken van een geverifieerde client is het gebruik van DefaultAzureCredential. Aangezien alle beheer-API's hetzelfde eindpunt doorlopen om te kunnen communiceren met resources, moet er slechts één ArmClient op het hoogste niveau worden gemaakt.

Voer de volgende code uit om te verifiëren bij Azure en een ArmClient te maken:

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

Interactie met Azure-resources

Nu u bent geverifieerd.

Voor elk van de volgende voorbeelden wijzen we onze resources voor de gebruikersnaam van de afzender toe aan een bestaande domeinresource.

Als u een e-mailcommunicatieservice moet maken, kunt u dit doen met behulp van Azure Portal en een domeinresource maken, kunt u dit doen met behulp van Azure Portal.

Een resource voor de gebruikersnaam van de afzender maken

Wanneer u een resource voor de gebruikersnaam van de afzender maakt, moet u de naam van de resourcegroep, de naam van de e-mailcommunicatieservice, de domeinnaam en de resourcenaam opgeven.

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

Resources voor gebruikersnaam van afzender beheren

Lijst per domeinresource

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

Gebruikersnaam van afzender ophalen

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

Een bron voor de gebruikersnaam van de afzender opschonen

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

Notitie

Het verwijderen van resources is permanent en er kunnen geen gegevens, waaronder event grid-filters, telefoonnummers of andere gegevens die aan uw resource zijn gekoppeld, worden hersteld als u de resource verwijdert.

Vereisten

Een resource voor de gebruikersnaam van de afzender maken

Als u een resource voor de gebruikersnaam van de afzender wilt maken, meldt u zich aan bij uw Azure-account met behulp van de Connect-AzAccount volgende opdracht en geeft u uw referenties op.

PS C:\> Connect-AzAccount

Zorg er eerst voor dat u de Azure Communication Services-module Az.Communication installeert met behulp van de volgende opdracht.

PS C:\> Install-Module Az.Communication

Voer de volgende opdracht uit om de gebruikersnaam van de afzender voor aangepast domein te maken:

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

Als u een specifiek abonnement wilt selecteren, kunt u ook de vlag --subscription opgeven en de abonnements-id opgeven.

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

U kunt uw domeinresource configureren met de volgende opties:

  • De resourcegroep
  • De naam van de Resource e-mailcommunicatieservices.
  • De naam van de domeinresource.
  • De naam van de gebruikersnaam van de afzender.
  • De naam van de gebruikersnaam.

Notitie

De gebruikersnaam en gebruikersnaam van de afzender moeten hetzelfde zijn.

De gebruikersnaamresource van de afzender beheren

Voer de volgende opdrachten uit om de weergavenaam toe te voegen of bij te werken aan de gebruikersnaam van de afzender. U kunt ook een specifiek abonnement instellen.

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

Als u alle resources voor de gebruikersnaam van de afzender in een bepaald domein wilt weergeven, gebruikt u de volgende opdracht:

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

Als u alle informatie over een bepaalde resource wilt weergeven, gebruikt u de volgende opdracht:

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

Een bron voor de gebruikersnaam van de afzender opschonen

Als u een bron voor de gebruikersnaam van de afzender wilt opschonen en verwijderen, kunt u de gebruikersnaamresource van de afzender verwijderen door de volgende opdracht uit te voeren:

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

Notitie

Het verwijderen van resources is permanent en er kunnen geen gegevens, waaronder event grid-filters, telefoonnummers of andere gegevens die aan uw resource zijn gekoppeld, worden hersteld als u de resource verwijdert.

Volgende stappen