Collegare istanze di SQL Server ad Azure Arc su larga scala con uno script

Azure PowerShell deve essere installato in ogni computer.

1. Creare l'entità servizio. Utilizzare il cmdlet New-AzADServicePrincipal. Verificare di archiviare l'output in una variabile. In caso contrario non sarà possibile recuperare la password necessaria successivamente.

   $sp = New-AzADServicePrincipal -DisplayName "Arc-for-servers" -Role <your custom role>
   $sp
   

2. Concedere all'entità servizio le autorizzazioni per accedere a Microsoft Graph.

   Nota

   • Quando si crea un'entità servizio, è necessario essere un proprietario o un amministratore Accesso utente nella sottoscrizione che si vuole usare per l'onboarding. Se non si hanno autorizzazioni sufficienti per creare assegnazioni di ruolo, l'entità servizio potrebbe essere creata, ma non sarà in grado di eseguire l'onboarding dei computer. Le istruzioni per creare un ruolo personalizzato sono disponibili in prerequisiti.

3. Recuperare la password archiviata nella variabile $sp:

   $credential = New-Object pscredential -ArgumentList "temp", $sp.PasswordCredentials.SecretText 
   $credential.GetNetworkCredential().password
   

4. Recuperare il valore dell'ID tenant dell'entità servizio:

   $tenantId= (Get-AzContext).Tenant.Id
   

5. Copiare e salvare i valori di password, ID applicazione e ID tenant usando le procedure di sicurezza appropriate. Se si dimentica o si perde la password dell'entità servizio, è possibile reimpostarla usando il cmdlet New-AzADSpCredential.

   Nota

   Si noti che Azure Arc per server non supporta attualmente l'accesso con un certificato, pertanto l'entità servizio deve avere un segreto con cui eseguire l'autenticazione.

6. Scaricare lo script di PowerShell dal portale seguendo le istruzioni riportate in Connettere l'istanza SQL Server ad Azure Arc.

7. Aprire lo script in un'istanza di amministrazione di PowerShell ISE e sostituire le variabili di ambiente seguenti usando i valori generati durante il provisioning dell'entità servizio descritto in precedenza. Queste variabili sono inizialmente vuote.

   $servicePrincipalAppId="{serviceprincipalAppID}"
   $servicePrincipalSecret="{serviceprincipalPassword}"
   $servicePrincipalTenantId="{serviceprincipalTenantId}"
   

8. Esegui lo script in ogni computer obiettivo.

In ogni computer di destinazione deve essere installata l'interfaccia della riga di comando di Azure. Lo script di registrazione esegue automaticamente l'accesso ad Azure con le credenziali dell'entità servizio, se sono disponibili e se nessun altro utente è già connesso. Usare la procedura seguente per connettere le istanze di SQL Server in più computer Linux.

1. Creare un'entità servizio usando il comando "az ad sp create-for-rbac".

   az ad sp create-for-rbac --name <your service principal name> --role <your custom role name> --scopes /subscriptions/<subscription id>
   

2. Scaricare lo script della shell di Linux dal portale seguendo le istruzioni riportate in Connettere l'istanza SQL Server ad Azure Arc.

   Nota

   Quando si crea un'entità servizio, è necessario essere un proprietario o un amministratore Accesso utente nella sottoscrizione che si vuole usare per l'onboarding. Se non si hanno autorizzazioni sufficienti per creare assegnazioni di ruolo, l'entità servizio potrebbe essere creata, ma non sarà in grado di eseguire l'onboarding dei computer. Le istruzioni per creare un ruolo personalizzato sono disponibili in prerequisiti.

3. Sostituire le variabili seguenti nello script usando i valori restituiti dal comando "az ad sp create-for-rbac". Queste variabili sono inizialmente vuote.

   servicePrincipalAppId="{serviceprincipalAppID}"
   servicePrincipalSecret="{serviceprincipalPassword}"
   servicePrincipalTenant="{serviceprincipalTenant}"
   

4. Eseguire lo script in ogni computer di destinazione

   sudo chmod +x ./RegisterSqlServerArc.sh
   ./RegisterSqlServerArc.sh