Azure SQL : se connecter avec Invoke-Sqlcmd via identité managée ou principal de service
Exemples de connexion à Azure SQL Database avec Invoke-Sqlcmd et sqlcmd, via identité managée, principal de service ou Azure AD interactif.
Exemples de connexion à Azure SQL Database depuis Invoke-Sqlcmd (PowerShell) et sqlcmd, avec authentification par identité managée (MSI) ou par principal de service Azure AD.
Invoke-Sqlcmd avec un jeton d'identité managée
Récupérer un jeton d'accès via le point de terminaison de métadonnées de l'instance (identité managée utilisateur) et l'utiliser avec Invoke-Sqlcmd :
$AppID = "https://database.windows.net"
$UamiID = "00000000-0000-0000-0000-000000000000"
$metadataUri = "http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=$AppID&object_id=$UamiID"
$request = Invoke-RestMethod -Uri $metadataUri -Headers @{Metadata = "true" }
$AccessToken = $request.access_token
$myArguments = @{
AccessToken = $AccessToken
ServerInstance = "myserver.database.windows.net"
Database = "mydatabase"
}
$myArguments.Query = "EXEC [dbo].[sp_ExportViews] @Destination = N'MSSQL', @Create_Drop = N'Y'"
Invoke-Sqlcmd @myArguments -Verbose 4>&1
sqlcmd avec un principal de service Azure AD
Le client sqlcmd (version moderne, ex. v1.8.2) prend en charge l'authentification ActiveDirectoryServicePrincipal : l'identifiant d'application du principal de service, suivi du @ et de l'identifiant du tenant, sert de nom d'utilisateur (-U) ; le secret du principal de service sert de mot de passe (-P).
sqlcmd --authentication-method ActiveDirectoryServicePrincipal ^
-S myserver.database.windows.net ^
-d mydatabase ^
-U <app-id>@<tenant-id> ^
-P "<PASSWORD>"
Vérifier la version installée :
sqlcmd --version
Vérifier l'identité et la base utilisées :
sqlcmd -S myserver.database.windows.net -d master -C -Q "SELECT SUSER_SNAME(), DB_NAME()" --authentication-method ActiveDirectoryServicePrincipal
sqlcmd en mode interactif (utilisateur Azure AD)
L'option -G active l'authentification Azure AD interactive (navigateur) ; -U précise alors le nom d'utilisateur Azure AD :
sqlcmd -S myserver.database.windows.net -d master -C -Q "SELECT SUSER_SNAME(), DB_NAME()" -G -U user@example.com
Notes
- Préférer une identité managée quand le script tourne sur une ressource Azure qui la supporte (VM, App Service, Azure Automation...) plutôt qu'un secret de principal de service à gérer.
- Ne jamais stocker un secret de principal de service en clair dans un script : utiliser un coffre de secrets (Azure Key Vault) ou une variable d'environnement protégée.
- Le format
Data Source=<serveur>;Initial Catalog=<base>;correspond à une chaîne de connexion ADO.NET classique pour Azure SQL.