Conectar as Instâncias do SQL Server ao Azure em escala com um script

Cada computador precisa ter o Azure PowerShell instalado.

1. Crie a entidade de serviço. Use o cmdlet New-AzADServicePrincipal. Armazene a saída em uma variável. Caso contrário, você não poderá recuperar a senha necessária mais tarde.

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

2. Forneça as permissões de entidade de serviço para acessar o Microsoft Graph.

   Observação

   • Quando você cria uma entidade de serviço, sua conta deve ser um Proprietário ou Administrador de Acesso de Usuário na assinatura que deseja usar para integração. Se você não tiver permissões suficientes para criar atribuições de função, a entidade de serviço poderá ser criada, mas não poderá integrar computadores. As instruções de como criar uma função personalizada são fornecidas em pré-requisitos.

3. Recupere a senha armazenada na variável $sp:

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

4. Recupere o valor da ID do locatário da entidade de serviço:

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

5. Copie e salve os valores da senha, da ID do aplicativo e da ID do locatário usando as práticas de segurança apropriadas. Se você esquecer ou perder a senha da entidade de serviço, poderá redefini-la usando o cmdlet New-AzADSpCredential.

   Observação

   Observe que, no momento, o Azure Arc para servidores não dá suporte à entrada com um certificado, portanto, a entidade de serviço precisa usar um segredo para autenticar-se.

6. Baixe o script do PowerShell no portal seguindo as instruções em Conectar o SQL Server com o Azure Arc.

7. Abra o script em uma instância de administrador do ISE do PowerShell e substitua as variáveis de ambiente a seguir usando os valores gerados durante o provisionamento da entidade de serviço já descrito. Essas variáveis estão inicialmente vazias.

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

8. Executar o script em cada computador de destino.

Cada computador de destino precisa ter a CLI do Azure instalada. O script de registro entrará automaticamente no Azure com as credenciais da entidade de serviço se elas tiverem sido fornecidas e se não houver nenhum outro usuário já conectado. Siga as etapas a seguir para conectar as instâncias do SQL Server em vários computadores Linux.

1. Crie a entidade de serviço usando o 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. Baixe o script de shell do Linux no portal seguindo as instruções em Conectar o SQL Server com o Azure Arc.

   Observação

   Quando você cria uma entidade de serviço, sua conta deve ser um Proprietário ou Administrador de Acesso de Usuário na assinatura que deseja usar para integração. Se você não tiver permissões suficientes para criar atribuições de função, a entidade de serviço poderá ser criada, mas não poderá integrar computadores. As instruções de como criar uma função personalizada são fornecidas em pré-requisitos.

3. Substitua as variáveis a seguir no script usando os valores retornados pelo comando 'az ad sp create-for-rbac'. Essas variáveis estão inicialmente vazias.

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

4. Executar o script em cada computador de destino

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