Aracılığıyla paylaş

Hızlı Başlangıç: Azure Yönetilen Etki Alanlarını E-posta İletişim Hizmeti'ne ekleme

  • Makale

Bu hızlı başlangıçta, Azure İletişim Hizmetleri'da Azure Yönetilen Etki Alanı'nı E-posta İletişim Hizmetine sağlamayı öğreneceksiniz.

Önkoşullar

Azure Yönetilen Etki Alanı sağlama

  1. E-posta İletişimi Kaynağı Oluşturmaya Başlama bölümünde oluşturduğunuz E-posta İletişim Hizmeti kaynağının Genel Bakış sayfasını açın.

  2. Aşağıdaki seçeneklerden birini kullanarak bir Azure Yönetilen Etki Alanı oluşturun.

    • (Seçenek 1) Ücretsiz Azure alt etki alanı ekle'nin altındaki 1 tıklamayla ekle düğmesine tıklayın. 3. adıma geçin.

    Ücretsiz Azure Yönetilen Etki Alanı ekleme işlemini vurgulayan ekran görüntüsü.

    • (Seçenek 2) Sol gezinti panelinde Etki Alanları Sağla'ya tıklayın.

    Etki Alanları Sağlama gezinti sayfasını gösteren ekran görüntüsü.

    • Üst gezinti çubuğunda Etki alanı ekle'ye tıklayın.
    • Açılan listeden Azure etki alanı'nı seçin.

  3. Dağıtımın tamamlanmasını bekleyin.

    Dağıtım İlerleme Durumunu gösteren ekran görüntüsü.

  4. Etki alanı oluşturulduktan sonra yeni etki alanına sahip bir liste görünümü görürsünüz.

    Sağlanan e-posta etki alanlarının listesini gösteren ekran görüntüsü.

  5. Sağlanan etki alanının adına tıklayarak etki alanı kaynak türünün genel bakış sayfasını açın.

    Azure Yönetilen Etki Alanına genel bakış sayfasını gösteren ekran görüntüsü.

Önkoşullar

Etki alanı kaynağı oluşturma

Etki alanı kaynağı oluşturmak için Azure CLI'da oturum açın. Terminalden komutunu çalıştırarak az login ve kimlik bilgilerinizi sağlayarak oturum açabilirsiniz. Kaynağı oluşturmak için aşağıdaki komutu çalıştırın:

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

Belirli bir aboneliği seçmek isterseniz bayrağını --subscription belirtebilir ve abonelik kimliğini belirtebilirsiniz.

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

Etki alanı kaynağınızı aşağıdaki seçeneklerle yapılandırabilirsiniz:

  • Kaynak grubu
  • E-posta İletişim Hizmetleri kaynağının adı
  • Kaynağın ilişkilendirileceği coğrafya
  • Etki alanı kaynağının adı:
    • Azure etki alanları için adın AzureManagedDomain olması gerekir.
  • Etki alanı yönetimi özelliğinin değeri.
    • Azure etki alanları için değer AzureManaged olmalıdır.

Sonraki adımda, etki alanı kaynağına etiket atayabilirsiniz. Etiketler, Etki alanı kaynaklarınızı düzenlemek için kullanılabilir. Etiketler hakkında daha fazla bilgi için kaynak etiketleme belgelerine bakın.

Etki alanı kaynağınızı yönetme

Etki alanı kaynağınıza etiket eklemek için aşağıdaki komutları çalıştırın. Belirli bir aboneliği de hedefleyebilirsiniz.

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

Belirli bir E-posta İletişim Hizmetindeki Tüm Etki Alanı Kaynaklarınızı listelemek için aşağıdaki komutu kullanın:

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

Belirli bir etki alanı kaynağındaki tüm bilgileri göstermek için aşağıdaki komutu kullanın:

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

Etki alanı kaynağını temizleme

Bir Etki Alanı kaynağını temizlemek ve kaldırmak istiyorsanız, aşağıdaki komutu çalıştırarak silebilirsiniz.

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

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Diğer komutlar hakkında daha fazla bilgi için bkz . Etki alanı CLI'sı.

Önkoşullar

  • Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
  • İşletim sisteminiz için en son sürüm .NET Core SDK'sı .
  • .NET Kimlik SDK'sının en son sürümünü alın.
  • .NET Yönetim SDK'sının en son sürümünü edinin.

SDK'yi yükleme

İlk olarak, C# projenize İletişim Hizmetleri Yönetim SDK'sını ekleyin:

using Azure.ResourceManager.Communication;

Subscription ID

Azure aboneliğinizin kimliğini bilmeniz gerekir. Bu, portaldan edinilebilir:

  1. Azure hesabınızda oturum açın
  2. Sol kenar çubuğunda Abonelikler'i seçin
  3. Hangi aboneliğin gerekli olduğunu seçin
  4. Genel Bakış'a tıklayın
  5. Abonelik Kimliğinizi seçin

Bu hızlı başlangıçta abonelik kimliğini adlı AZURE_SUBSCRIPTION_IDbir ortam değişkeninde depoladığınız varsayılır.

Kimlik Doğrulaması

Etki alanı kaynağıyla iletişim kurmak için önce Azure'da kimliğinizi doğrulamanız gerekir.

İstemcinin Kimliğini Doğrulama

Kimliği doğrulanmış istemci oluşturmak için varsayılan seçenek DefaultAzureCredential kullanmaktır. Tüm yönetim API'leri aynı uç noktadan geçtiğinden kaynaklarla etkileşim kurmak için yalnızca bir üst düzey ArmClient oluşturulması gerekir.

Azure'da kimlik doğrulaması yapmak ve ArmClient oluşturmak için aşağıdaki kodu yapın:

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 kaynaklarıyla etkileşim kurma

Artık kimliğiniz doğrulandı.

Aşağıdaki örneklerin her biri için, Etki alanı kaynaklarımızı mevcut bir E-posta iletişim hizmetine atayacağız.

E-posta İletişim Hizmeti oluşturmanız gerekiyorsa Azure portalını kullanarak bunu yapabilirsiniz.

Etki alanı kaynağı oluşturma

Etki alanı kaynağı oluştururken kaynak grubu adını, E-posta İletişim Hizmeti adını, kaynak adını ve DomainManagement'ı belirtmeniz gerekir.

Not

Location özelliği her zaman globalşeklindedir.

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

Etki Alanı Kaynaklarınızı yönetme

Etki alanı kaynağını güncelleştirme

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

E-posta Hizmetine Göre Listele

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

Etki alanı kaynağını alma

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

Etki alanı kaynağını temizleme

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

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Önkoşullar

Etki alanı kaynağı oluşturma

Etki alanı kaynağı oluşturmak için aşağıdaki komutu kullanarak Connect-AzAccount Azure hesabınızda oturum açın ve kimlik bilgilerinizi sağlayın.

PS C:\> Connect-AzAccount

İlk olarak, aşağıdaki komutu kullanarak Azure İletişim Hizmetleri modülünü Az.Communication yüklediğinizden emin olun.

PS C:\> Install-Module Az.Communication

Azure tarafından yönetilen etki alanı kaynağını oluşturmak için aşağıdaki komutu çalıştırın:

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

Etki alanı kaynağınızı aşağıdaki seçeneklerle yapılandırabilirsiniz:

  • Kaynak grubu
  • E-posta İletişim Hizmetleri kaynağının adı.
  • Etki alanı kaynağının adı:
    • Azure etki alanları için ad : AzureManagedDomain olmalıdır.
  • Etki alanı yönetimi özelliğinin değeri.
    • Azure etki alanları için değer AzureManaged olmalıdır.

Sonraki adımda, etki alanı kaynağına etiket atayabilirsiniz. Etiketler, Etki alanı kaynaklarınızı düzenlemek için kullanılabilir. Etiketler hakkında daha fazla bilgi için kaynak etiketleme belgelerine bakın.

Etki alanı kaynağınızı yönetme

Etki alanı kaynağınıza etiket eklemek için aşağıdaki komutları çalıştırın. Belirli bir aboneliği de hedefleyebilirsiniz.

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

Belirli bir E-posta İletişim Hizmetindeki Tüm Etki Alanı Kaynaklarınızı listelemek için aşağıdaki komutu kullanın:

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

Belirli bir etki alanı kaynağındaki tüm bilgileri listelemek için aşağıdaki komutu kullanın:

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

Etki alanı kaynağını temizleme

Bir Etki Alanı kaynağını temizlemek ve kaldırmak istiyorsanız, aşağıdaki komutu çalıştırarak Etki alanı kaynağınızı silebilirsiniz:

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

Not

Kaynak silme kalıcıdır ve kaynağı silerseniz olay kılavuzu filtreleri, telefon numaraları veya kaynağınıza bağlı diğer veriler de dahil olmak üzere hiçbir veri kurtarılamaz.

Azure Yönetilen Etki Alanları ile Özel Etki Alanları karşılaştırması

Azure Yönetilen Etki Alanı sağlamadan önce, gereksinimlerinizi en iyi karşılayan etki alanı türüne karar vermek için aşağıdaki tabloyu gözden geçirin.

Azure Yönetilen Etki Alanları Özel Etki Alanları
Profesyonel: - Kurulum hızlı ve kolaydır
- Etki alanı doğrulaması gerekmez
 - E-postalar kendi etki alanınızdan gönderilir
Eksi -lerini: - Gönderen etki alanı kişiselleştirilmiş değil ve değiştirilemez
- Gönderen kullanıcı adları kişiselleştirilemiyor
- Çok sınırlı gönderme hacmi
- Kullanıcı Katılımı İzleme etkinleştirilemiyor
- Etki alanı kayıtlarının doğrulanmasını gerektirir
- Doğrulama için daha uzun kurulum

Azure Yönetilen Etki Alanı için gönderen kimlik doğrulaması

Azure İletişim Hizmetleri, e-posta için gerekli e-posta kimlik doğrulama protokollerini içinde açıklandığı gibi otomatik olarak yapılandırıyorE-posta Kimlik Doğrulaması en iyi yöntemleri.

E-posta etki alanınız artık e-posta göndermeye hazırdır.

Sonraki adımlar