Affecter un domaine personnalisé à une application web à l'aide de PowerShellAssign a custom domain to a web app using PowerShell

Cet exemple de script crée une application web dans App Service avec ses ressources associées, puis la mappe à www.<yourdomain>.This sample script creates a web app in App Service with its related resources, and then maps www.<yourdomain> to it.

Si nécessaire, installez Azure PowerShell à l’aide des instructions figurant dans le Guide Azure PowerShell, puis exécutez Connect-AzAccount pour créer une connexion avec Azure.If needed, install the Azure PowerShell using the instruction found in the Azure PowerShell guide, and then run Connect-AzAccount to create a connection with Azure. Vous devez également avoir accès à la page de configuration DNS du bureau d’enregistrement de votre domaine.Also, you need to have access to your domain registrar's DNS configuration page.

Exemple de scriptSample script

Notes

Cet article a été mis à jour pour tenir compte de l’utilisation du nouveau module Az d’Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Vous pouvez toujours utiliser le module AzureRM, qui continue à recevoir des correctifs de bogues jusqu’à au moins décembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Pour en savoir plus sur le nouveau module Az et la compatibilité avec AzureRM, consultez Présentation du nouveau module Az d’Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pour des instructions d’installation du module Az, consultez Installer Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

$fqdn="<Replace with your custom domain name>"
$webappname="mywebapp$(Get-Random)"
$location="West Europe"

# Create a resource group.
New-AzResourceGroup -Name $webappname -Location $location

# Create an App Service plan in Free tier.
New-AzAppServicePlan -Name $webappname -Location $location `
-ResourceGroupName $webappname -Tier Free

# Create a web app.
New-AzWebApp -Name $webappname -Location $location -AppServicePlan $webappname `
-ResourceGroupName $webappname

Write-Host "Configure a CNAME record that maps $fqdn to $webappname.azurewebsites.net"
Read-Host "Press [Enter] key when ready ..."

# Before continuing, go to your DNS configuration UI for your custom domain and follow the 
# instructions at https://aka.ms/appservicecustomdns to configure a CNAME record for the 
# hostname "www" and point it your web app's default domain name.

# Upgrade App Service plan to Shared tier (minimum required by custom domains)
Set-AzAppServicePlan -Name $webappname -ResourceGroupName $webappname `
-Tier Shared

# Add a custom domain name to the web app. 
Set-AzWebApp -Name $webappname -ResourceGroupName $webappname `
-HostNames @($fqdn,"$webappname.azurewebsites.net")

Nettoyer le déploiementClean up deployment

Une fois l’exemple de script exécuté, la commande suivante permet de supprimer le groupe de ressources, l’application web et toutes les ressources associées.After the script sample has been run, the following command can be used to remove the resource group, web app, and all related resources.

Remove-AzResourceGroup -Name myResourceGroup -Force

Explication du scriptScript explanation

Ce script utilise les commandes suivantes.This script uses the following commands. Chaque commande du tableau renvoie à une documentation spécifique.Each command in the table links to command specific documentation.

CommandeCommand NotesNotes
New-AzResourceGroupNew-AzResourceGroup Crée un groupe de ressources dans lequel toutes les ressources sont stockées.Creates a resource group in which all resources are stored.
New-AzAppServicePlanNew-AzAppServicePlan Crée un plan App Service.Creates an App Service plan.
New-AzWebAppNew-AzWebApp Crée une application web.Creates a web app.
Set-AzAppServicePlanSet-AzAppServicePlan Modifie le niveau tarifaire d’un plan App Service.Modifies an App Service plan to change its pricing tier.
Set-AzWebAppSet-AzWebApp Modifie la configuration d’une application web.Modifies a web app's configuration.

Étapes suivantesNext steps

Pour plus d’informations sur le module Azure PowerShell, consultez la Documentation Azure PowerShell.For more information on the Azure PowerShell module, see Azure PowerShell documentation.

Vous trouverez des exemples supplémentaires de scripts Azure PowerShell pour Azure App Service Web Apps sur la page Azure PowerShell Samples (Exemples Azure PowerShell).Additional Azure Powershell samples for Azure App Service Web Apps can be found in the Azure PowerShell samples.