Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- author: v-vprasannak ms.service: azure-communication-services ms.custom: devx-track-azurepowershell ms.topic: include ms.date: 04/29/2024 ms.author: v-vprasannak --- ## Prerequisites - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). - Install the [Azure Az PowerShell Module](/powershell/azure/). - Create an [Email Communication Service](/azure/communication-services/quickstarts/email/create-email-communication-resource). ## Create a Domain resource To create a Domain resource, sign into your Azure account using ```Connect-AzAccount``` with the following command and provide your credentials. ```PowerShell PS C:\> Connect-AzAccount ``` First, install the Azure Communication Services module ```Az.Communication``` using the following command. ```PowerShell PS C:\> Install-Module Az.Communication ``` Run the following command to create the Azure managed domain resource: ```PowerShell PS C:\> New-AzEmailServiceDomain -ResourceGroupName ContosoResourceProvider1 -EmailServiceName ContosoEmailServiceResource1 -Name AzureManagedDomain -DomainManagement AzureManaged ``` You can configure your Domain resource with the following options: * The [resource group](../../../../azure-resource-manager/management/manage-resource-groups-powershell.md) * The name of the Email Communication Services resource. * The name of the Domain resource: * For Azure domains, the name must be `AzureManagedDomain`. * The value of the Domain management property. * For Azure domains, the value must be `AzureManaged`. In the next step, you can assign tags to the domain resource. Tags can be used to organize your Domain resources. For more information about tags, see the [resource tagging documentation](../../../../azure-resource-manager/management/tag-resources.md). ## Manage your Domain resource To add tags to your Domain resource, run the following commands. You can also target a specific subscription. ```PowerShell 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 ``` To list all of your Domain Resources in a given Email Communication Service, use the following command: ```PowerShell PS C:\> Get-AzEmailServiceDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 ``` To list all the information on a given domain resource, use the following command: ```PowerShell PS C:\> Get-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 ``` ## Clean up a Domain resource If you want to clean up and remove a Domain resource, you can delete your Domain resource by running the following command: ```PowerShell PS C:\> Remove-AzEmailServiceDomain -Name AzureManagedDomain -EmailServiceName ContosoEmailServiceResource1 -ResourceGroupName ContosoResourceProvider1 ``` > [!NOTE] > Resource deletion is **permanent** and no data, including Event Grid filters, phone numbers, or other data tied to your resource, can be recovered if you delete the resource.