Partager via

Prise en charge de PowerShell pour les clusters de passerelle de données locaux

Les scripts PowerShell sont disponibles dans la galerie PowerShell. Les scripts décrits dans cet article concernent PowerShell version 5. Lorsque vous utilisez PowerShell version 7, reportez-vous aux applets de commande PowerShell pour la gestion de la passerelle de données locale. Vous pouvez utiliser les scripts PowerShell pour effectuer les opérations suivantes :

  • Récupérez la liste des clusters de passerelle disponibles pour un utilisateur.
  • Récupérez la liste des instances de passerelle inscrites dans un cluster et leur état en ligne ou hors connexion.
  • Modifiez l’état d’activation ou de désactivation d’une instance de passerelle au sein d’un cluster et d’autres propriétés de passerelle.
  • Supprimez une passerelle.

Exécuter les commandes PowerShell

Pour installer ces applets de commande, exécutez la commande suivante dans une session PowerShell avec élévation de privilèges :

Install-Module -Name OnPremisesDataGatewayHAMgmt

La liste complète des applets de commande est disponible à l’aide de la commande suivante :

Get-Command -Module OnPremisesDataGateway*

Les exemples et descriptions sont inclus dans les applets de commande et vous pouvez y accéder à l’aide de la commande suivante :

get-help <cmdlet-name>

Vous pouvez maintenant utiliser les commandes du tableau suivant pour gérer vos clusters de passerelle.

Commande Description Paramètres
Login-OnPremisesDataGateway Utilisez cette commande pour vous connecter pour gérer vos clusters de passerelle de données locaux. Vous devez exécuter cette commande et vous connecter avant que d’autres commandes de haute disponibilité puissent fonctionner correctement. Remarque : Le jeton d’authentification Microsoft Entra ID acquis dans le cadre d’un login appel est valide pendant seulement 1 heure, après laquelle il expire. Vous pouvez réexécuter la login commande pour acquérir un nouveau jeton. Nom d’utilisateur et mot de passe de Microsoft Entra ID (fourni dans le cadre de l’exécution de la commande, pas d’appel initial).
Get-OnPremisesDataGatewayClusters Récupère la liste des clusters de passerelle pour l’utilisateur connecté. Si vous le souhaitez, vous pouvez transmettre des paramètres de mise en forme à cette commande pour une meilleure lisibilité, telle queFormat-Table -AutoSize -Wrap.
Get-OnPremisesDataClusterGateways Récupère la liste des passerelles au sein du cluster spécifié et des informations supplémentaires pour chaque passerelle, comme l’état en ligne ou hors connexion et le nom de l’ordinateur. -ClusterObjectID xyz (où xyz est remplacé par une valeur d’ID d’objet de cluster réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataGatewayClusters ).
Set-OnPremisesDataGateway Utilisez cette commande pour définir des valeurs de propriété pour une passerelle donnée au sein d’un cluster, ce qui inclut la possibilité d’activer ou de désactiver une instance de passerelle spécifique. -ClusterObjectID xyz (où xyz est remplacé par une valeur d’ID d’objet de cluster réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (où abc est remplacé par une valeur d’ID d’objet de passerelle réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataClusterGateways , en fonction d’un ID d’objet de cluster).
Get-OnPremisesDataGatewayStatus Utilisez cette commande pour récupérer l’état d’une instance de passerelle donnée au sein d’un cluster. -ClusterObjectID xyz (où xyz est remplacé par une valeur d’ID d’objet de cluster réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (où abc est remplacé par une valeur d’ID d’objet de passerelle réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataClusterGateways , en fonction d’un ID d’objet de cluster).
Remove-OnPremisesDataGateway Utilisez cette commande pour supprimer une instance de passerelle d’un cluster. Remarque : la passerelle principale du cluster ne peut pas être supprimée tant que toutes les autres passerelles du cluster ne sont pas supprimées. -ClusterObjectID xyz (où xyz est remplacé par une valeur d’ID d’objet de cluster réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataGatewayClusters ).

-GatewayObjectID abc (où abc est remplacé par une valeur d’ID d’objet de passerelle réelle, qui peut être récupérée à l’aide de la commande Get-OnPremisesDataClusterGateways , en fonction d’un ID d’objet de cluster).

Contenu connexe