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

Artigo
12/18/2024

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 método requer 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. Você pode concluir esse processo interativamente ou remotamente em um servidor Windows usando a comunicação remota do PowerShell.

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 liga 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 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 ligação, é instalada uma extensão no seu servidor com Azure Arc ativado e serão aplicadas novas funções ao seu SQL Server e às bases 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 Gerir a ligação automática para SQL Server ativada 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>
```
  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

Para 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. Use o Enable-PSRemoting cmdlet para isso.

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 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.

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.

Partilhar via