Conectar máquinas híbridas ao Azure usando o PowerShell

Artigo
04/16/2024

Para servidores habilitados com o Azure Arc, você pode executar etapas manuais para habilitá-los para uma ou mais máquinas Windows ou Linux em seu ambiente. Como alternativa, 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.

Esse método requer que você tenha permissões de administrador na máquina para instalar e configurar o agente. No Linux, usando a conta raiz, e no Windows, você é membro do grupo Administradores Locais. Você pode concluir esse processo interativamente ou remotamente em um servidor Windows usando a comunicação remota do PowerShell.

Antes de começar, revise os pré-requisitos e verifique se sua assinatura e recursos atendem aos 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 serão conectadas automaticamente ao Azure Arc. O SQL Server habilitado pelo Azure Arc fornece um inventário detalhado e recursos de gerenciamento adicionais para suas instâncias e bancos de dados 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 serão aplicadas ao seu SQL Server e bancos de dados. Se não quiser conectar automaticamente seus SQL Servers ao Azure Arc, você pode desativar adicionando uma tag ao servidor Windows ou Linux com o nome ArcSQLServerExtensionDeployment e o valor Disabled quando ele estiver conectado ao Azure Arc.

Para obter mais informações, consulte Gerenciar conexão automática para SQL Server habilitada pelo Azure Arc.

Pré-requisitos

Uma máquina com o Azure PowerShell. Para obter instruções, consulte Instalar e configurar o Azure PowerShell.

Você usa o PowerShell para gerenciar extensões de VM em seus servidores híbridos gerenciados por servidores habilitados para Azure Arc. Antes de usar o PowerShell, instale o Az.ConnectedMachine módulo no servidor que você deseja habilitar para Arc-enable. Execute o seguinte comando no servidor habilitado com o Azure Arc:

Install-Module -Name Az.ConnectedMachine

Quando a instalação terminar, você verá a seguinte mensagem:

The installed extension ``Az.ConnectedMachine`` is experimental and not covered by customer support. Please use with discretion.

Instalar o agente e conectar-se ao Azure

Abra um console do PowerShell com privilégios elevados.
Entre no Azure executando o comando Connect-AzAccount.
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>
```
  Usando essa configuração, o agente se comunica 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

Veja como configurar um ou mais servidores Windows com servidores habilitados com o Azure Arc. Você deve habilitar a comunicação remota do PowerShell na máquina remota. Para tal, utilize o cmdlet Enable-PSRemoting.

Abra um console do PowerShell como administrador.
Entre no Azure executando o comando Connect-AzAccount.

Para instalar o agente Máquina Conectada, use Connect-AzConnectedMachine com os -ResourceGroupNameparâmetros , e -Location . Os nomes de recursos do Azure usarão 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.

Captura de tela do painel Servidores, mostrando uma conexão de servidor bem-sucedida.

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 VM, verificar se a máquina está relatando para o espaço de trabalho esperado do Log Analytics e habilitar o monitoramento com insights de VM.