Ligar máquinas híbridas ao Azure utilizando o PowerShell

Você pode usar o cmdlet do PowerShell Connect-AzConnectedMachine para baixar o agente Connected Machine, instalar o agente e registrar a máquina no Azure Arc. O cmdlet baixa o pacote do agente do Windows (Windows Installer) do Centro de Download da Microsoft e o pacote do agente Linux do repositório de pacotes da Microsoft.

Este artigo orienta-o na instalação do agente diretamente na máquina de destino ou na sua implantação remota, recorrendo ao PowerShell remoting, a partir de outro sistema.

Antes de começar, reveja os pré-requisitos e verifique se a sua subscrição e os recursos cumprem os requisitos. Para obter informações sobre regiões com suporte e outras considerações relacionadas, consulte Regiões do Azure com suporte.

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Conexão automática para SQL Server

Quando você conecta um servidor Windows ou Linux ao Azure Arc que também tem o Microsoft SQL Server instalado, as instâncias do SQL Server também são conectadas automaticamente ao Azure Arc. O SQL Server ativado pelo Azure Arc fornece um inventário detalhado e capacidades de gestão adicionais para as suas bases de dados e instâncias do SQL Server. Como parte do processo de conexão, uma extensão é implantada em seu servidor habilitado para Arco do Azure e novas funções são aplicadas ao SQL Server e aos bancos de dados. Se você não quiser conectar automaticamente seus SQL Servers ao Azure Arc, poderá desativar adicionando uma tag ao servidor Windows ou Linux com o nome ArcSQLServerExtensionDeployment e o valor Disabled ao conectá-lo ao Azure Arc.

Para obter mais informações, consulte Gerir a ligação automática para SQL Server ativada pelo Azure Arc.

Pré-requisitos

• Máquina Windows ou Linux que você deseja conectar ao Azure Arc usando o PowerShell. O Az.ConnectedMachine módulo suporta o gerenciamento de máquinas Windows e Linux.

• Permissões de administrador na máquina para instalar e configurar o agente. No Linux, usando a conta root e no Windows, você é membro do grupo Administradores Locais.

• Azure PowerShell para as máquinas de destino. Para obter instruções, consulte Instalar e configurar o Azure PowerShell.

  Você usa o PowerShell para gerenciar extensões de VM em suas máquinas híbridas gerenciadas por servidores habilitados para Azure Arc. Antes de usar o PowerShell, instale o Az.ConnectedMachine módulo na máquina que você deseja habilitar o Arc. Execute o seguinte comando em sua máquina habilitada com o Azure Arc:

  Install-Module -Name Az.ConnectedMachine
  

Instalar o agente e conectar-se ao Azure

Conclua as etapas a seguir para instalar o agente diretamente na máquina.

1. Abra um console do PowerShell com privilégios elevados.

2. Entre no Azure executando o comando Connect-AzAccount.

3. Para instalar o agente Connected Machine, use Connect-AzConnectedMachine com os -Nameparâmetros , -ResourceGroupNamee -Location . Use o -SubscriptionId parâmetro para substituir a assinatura padrão como resultado do contexto do Azure criado após o login. Execute um dos seguintes comandos:

   • Para instalar o agente de Máquina Conectada na máquina de destino que pode se comunicar diretamente com o Azure, execute:

     Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Name myMachineName -Location <region>
     

   • Para instalar o agente de Máquina Conectada na máquina de destino que se comunica por meio de um servidor proxy, execute:

     Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Name myMachineName -Location <region> -Proxy http://<proxyURL>:<proxyport>
     

     O agente usa essa configuração para se comunicar através do servidor proxy usando o protocolo HTTP.

Se o agente falhar ao iniciar após a conclusão da instalação, verifique os logs para obter informações detalhadas sobre erros. No Windows, verifique este arquivo: %ProgramData%\AzureConnectedMachineAgent\Log\himds.log. No Linux, verifique este arquivo: /var/opt/azcmagent/log/himds.log.

Instalar e conectar-se usando a comunicação remota do PowerShell

Conclua as etapas a seguir para usar a comunicação remota do PowerShell para instalar o agente em sistemas remotos.

1. Abra um console do PowerShell como administrador.

2. Entre no Azure executando o comando Connect-AzAccount.

3. Para instalar o agente Máquina Conectada, use Connect-AzConnectedMachine com os -ResourceGroupNameparâmetros , e -Location . Os nomes de recursos do Azure usam automaticamente o nome do host de cada servidor. Use o -SubscriptionId parâmetro para substituir a assinatura padrão como resultado do contexto do Azure criado após o login.

   • Para instalar o agente de Máquina Conectada na máquina de destino que pode se comunicar diretamente com o Azure, execute o seguinte comando:

     $sessions = New-PSSession -ComputerName myMachineName
     Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Location <region> -PSSession $sessions
     

   • Para instalar o agente Máquina Conectada em várias máquinas remotas ao mesmo tempo, adicione uma lista de nomes de máquinas remotas, cada uma separada por uma vírgula.

     $sessions = New-PSSession -ComputerName myMachineName1, myMachineName2, myMachineName3
     Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Location <region> -PSSession $sessions
     

   O exemplo a seguir mostra os resultados do comando direcionado a uma única máquina:

   time="2020-08-07T13:13:25-07:00" level=info msg="Onboarding Machine. It usually takes a few minutes to complete. Sometimes it may take longer depending on network and server load status."
   time="2020-08-07T13:13:25-07:00" level=info msg="Check network connectivity to all endpoints..."
   time="2020-08-07T13:13:29-07:00" level=info msg="All endpoints are available... continue onboarding"
   time="2020-08-07T13:13:50-07:00" level=info msg="Successfully Onboarded Resource to Azure" VM Id=f65bffc7-4734-483e-b3ca-3164bfa42941
   
   Name           Location OSName   Status     ProvisioningState
   ----           -------- ------   ------     -----------------
   myMachineName  eastus   windows  Connected  Succeeded
   

Verificar a ligação com o Azure Arc

Depois de instalar e configurar o agente para se registrar com servidores habilitados para Azure Arc, vá para o portal do Azure para verificar se o servidor se conectou com êxito. Exiba sua máquina no portal do Azure.

Próximos passos

• Se necessário, consulte o guia do agente Solucionar problemas de máquina conectada.

• Revise o guia de planejamento e implantação para planejar a implantação de servidores habilitados para Azure Arc em qualquer escala e implementar gerenciamento e monitoramento centralizados.

• Saiba como gerenciar sua máquina usando a Política do Azure. Você pode usar a configuração de convidado de máquina virtual (VM), verificar se a máquina está relatando para o espaço de trabalho esperado do Log Analytics e habilitar o monitoramento com informações de máquina virtual (VM).