Utilisation de PowerCLI et de l’API des opérations du système invité

Vous pouvez utiliser l’API des opérations du système invité vSphere ou les applets de commande PowerCLI Invoke-VMScript et Copy-VMGuestFile dans vos workflows de personnalisation.

Avant de pouvoir utiliser l’API des opérations du système invité vSphere directement ou via PowerCLI, vous devez configurer une connexion Direct Connect, ou un VPN de calcul et une règle de pare-feu de réseau de gestion autorisant le trafic vers les hôtes ESXi sur le port 443.

Conditions préalables

Configurez l’une de ces solutions ou les deux entre votre environnement sur site et votre SDDC.
- VPN de gestion
- Connexion Direct Connect via une interface virtuelle privée (VIF)
Reportez-vous à Démarrage de VMware Cloud on AWS et Mise en réseau et sécurité de VMware Cloud on AWS.
Créez une règle de pare-feu de réseau de gestion qui autorise l'accès de votre réseau sur site au port 443 de vos hôtes SDDC. Reportez-vous à la section Ajouter ou modifier des règles de pare-feu de passerelle de gestion. Notez que l'assistant de configuration de MGW et l’accélérateur de règles de pare-feu créent cette règle automatiquement, il est donc possible qu’elle existe déjà pour votre VPN de gestion.

Procédure

Vérifiez que la machine virtuelle exécute la dernière version de VMware Tools.
Vérifiez que vous pouvez accéder à l’API des opérations du système invité, directement ou via une applet de commande PowerCLI simple.
Vous pouvez utiliser une applet de commande semblable à celle-ci pour tester la possibilité d’atteindre le port 443 sur l'hôte ESXi à l'adresse IP 10.100.1.1.
```
PS C:\Users\admin>Test-NetConnection -Port 443 -ComputerName 10.100.1.1
```
Une réponse True ou TcpTestSucceeded confirme la réussite du test.

Exemple : Utilisation de l’applet de commande PowerCLI Invoke-VMScript Cmdlet

Après l’établissement d’une connexion réseau qui autorise le trafic vers le port 443 sur vos hôtes, vous pouvez utiliser l'API des opérations du système invité, directement ou via PowerCLI comme indiqué ici. Les demandes de l'API et de l'applet de commande sont adressées au port 443 sur l'hôte sur lequel s'exécute la machine virtuelle concernée (ici Win10-Example). VMware Tools en cours d'exécution sur la machine virtuelle gère les opérations du système invité demandées.

PS C:\Users\admin> $vm = Get-VM Win10-Example
PS C:\Users\admin> Invoke-VMScript -ScriptText "dir C:\" -VM $vm -GuestUser admin -GuestPassword $passwd"

ScriptOutput
------------------------------------------------------
|
| Directory: C:\
|
| ...