Partager via


Connecter des machines hybrides à Azure à l’aide de PowerShell

Vous pouvez utiliser la cmdlet PowerShell Connect-AzConnectedMachine pour télécharger l’agent Connected Machine, installer l’agent et inscrire l’ordinateur auprès d’Azure Arc. La cmdlet télécharge le package de l’agent Windows (Windows Installer) à partir du centre de téléchargement de Microsoft et le package de l’agent Linux à partir du référentiel de packages de Microsoft.

Cet article vous guide tout au long de l'installation de l'agent directement sur l'ordinateur cible ou de son déploiement à distance depuis un autre système en utilisant PowerShell Remoting.

Avant de commencer, consulter les prérequis et vérifiez que votre abonnement et vos ressources répondent aux exigences. Pour plus d'informations sur les régions prises en charge et d'autres considérations connexes, consultez Régions Azure prises en charge.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Connexion automatique pour SQL Server

Lorsque vous connectez un serveur Windows ou Linux à Azure Arc sur lequel Microsoft SQL Server est également installé, les instances SQL Server sont également connectées automatiquement à Azure Arc. SQL Server activé par Azure Arc fournit un inventaire détaillé et des fonctionnalités de gestion supplémentaires pour vos instances et bases de données SQL Server. Dans le cadre du processus de connexion, une extension est déployée sur votre serveur avec Azure Arc et les nouveaux rôles sont appliqués à vos bases de données et sql Server. Si vous ne souhaitez pas connecter automatiquement vos serveurs SQL à Azure Arc, vous pouvez choisir d’ajouter une balise au serveur Windows ou Linux avec le nom ArcSQLServerExtensionDeployment et la valeur Disabled lors de sa connexion à Azure Arc.

Pour plus d’informations, consultez Gérer la connexion automatique pour une instance SQL Server activée par Azure Arc.

Prérequis

  • Machine Windows ou Linux que vous souhaitez connecter à Azure Arc à l’aide de PowerShell. Le Az.ConnectedMachine module prend en charge la gestion des machines Windows et Linux.

  • Autorisations d’administrateur sur l’ordinateur pour installer et configurer l’agent. Sur Linux, vous utilisez le compte root et, sur Windows, vous êtes membre du groupe Administrateurs local.

  • Azure PowerShell sur les machines cibles. Pour obtenir des instructions, consultez la rubrique Installation et configuration d'Azure PowerShell.

    Vous utilisez PowerShell pour gérer les extensions de machine virtuelle sur vos machines hybrides gérées par des serveurs avec Azure Arc. Avant d’utiliser PowerShell, installez le Az.ConnectedMachine module sur l’ordinateur que vous souhaitez activer avec Arc. Exécutez la commande suivante sur votre ordinateur activé avec Azure Arc :

    Install-Module -Name Az.ConnectedMachine
    

Installer l’agent et le connecter à Azure

Effectuez les étapes suivantes pour installer l’agent directement sur l’ordinateur.

  1. Ouvrez une console PowerShell avec des privilèges élevés.

  2. Connectez-vous à Azure en exécutant la commande Connect-AzAccount.

  3. Pour installer l’agent Connected Machine, utilisez Connect-AzConnectedMachine avec les paramètres -Name, -ResourceGroupNameet -Location. Utilisez le paramètre -SubscriptionId pour remplacer l’abonnement par défaut à la suite du contexte Azure créé après la connexion. Exécutez l’une des commandes suivantes :

    • Pour installer l’agent Connected Machine sur la machine cible pouvant directement communiquer avec Azure, exécutez :

      Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Name myMachineName -Location <region>
      
    • Pour installer l’agent Connected Machine sur la machine cible communiquant directement via un serveur proxy, exécutez :

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

      L’agent utilise cette configuration pour communiquer par le biais du serveur proxy en utilisant le protocole HTTP.

Si le démarrage de l’agent échoue une fois l’installation terminée, recherchez des informations détaillées sur l’erreur dans les journaux. Sous Windows, consultez ce fichier : %ProgramData%\AzureConnectedMachineAgent\Log\himds.log. Sous Linux, consultez ce fichier : /var/opt/azcmagent/log/himds.log.

Installer et se connecter à l’aide de la communication à distance PowerShell

Effectuez les étapes suivantes pour utiliser la communication à distance PowerShell pour installer l’agent sur des systèmes distants.

Note

Pour configurer des serveurs Windows à partir d’une machine avec Azure Arc, activez la communication à distance PowerShell sur chaque serveur cible en exécutant l’applet Enable-PSRemoting de commande.

  1. Ouvrez une console PowerShell en tant qu’administrateur.

  2. Connectez-vous à Azure en exécutant la commande Connect-AzAccount.

  3. Pour installer l’agent Connected Machine, utilisez Connect-AzConnectedMachine avec les paramètres -ResourceGroupName et -Location. Les noms des ressources Azure utilisent automatiquement le nom d’hôte de chaque serveur. Utilisez le paramètre -SubscriptionId pour remplacer l’abonnement par défaut à la suite du contexte Azure créé après la connexion.

    • Pour installer l’agent Connected Machine sur la machine cible pouvant directement communiquer avec Azure, exécutez la commande suivante :

      $sessions = New-PSSession -ComputerName myMachineName
      Connect-AzConnectedMachine -ResourceGroupName myResourceGroup -Location <region> -PSSession $sessions
      
    • Pour installer l’agent Connected Machine sur plusieurs ordinateurs distants en même temps, ajoutez la liste des noms d’ordinateurs distants, séparés par une virgule.

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

    L’exemple suivant illustre les résultats de la commande ciblant un seul ordinateur :

    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
    

Vérifier la connexion avec Azure Arc

Après avoir installé et configuré l’agent de manière à inscrire les serveurs compatibles avec Azure Arc, accédez au portail Azure pour vérifier que le serveur s’est correctement connecté. Affichez vos machines dans le portail Azure.

Capture d’écran du tableau de bord des serveurs, montrant une connexion serveur réussie.

Étapes suivantes