Kyvernon

Procédure Pour: développeurs

PowerCLI

Connecter PowerCLI au contrôleur, les cmdlets vérifiées avec Kyvernon et les limites connues.

PowerCLI se connecte au point de terminaison SOAP du contrôleur et, pour les étiquettes, au service de jetons et au point de terminaison REST. La vérification enregistrée a utilisé PowerShell 7.6.9 avec VMware.PowerCLI 13.3.0.24145083.

Avant de commencer

  • Activez les points de terminaison de compatibilité : Paramètres des points de terminaison de compatibilité.
  • Utilisez le nom ou l'adresse du contrôleur, le port 8443 et le compte d'un utilisateur Kyvernon.
  • Le contrôleur utilise un certificat que PowerCLI ne connaît pas par défaut. Faites confiance au certificat sur la machine qui exécute PowerCLI. Pour un test, vous pouvez l'accepter pour la session avec -InvalidCertificateAction Ignore. Derrière un proxy qui présente un autre certificat, définissez trust_certificate_file sur le contrôleur, car PowerCLI épingle le service de jetons au certificat que publie le service de recherche.

Avec la CLI

PowerShell
Set-PowerCLIConfiguration -Scope Session -InvalidCertificateAction Ignore -Confirm:$false
$cred = Get-Credential
Connect-VIServer -Server controller.example.com -Port 8443 -Credential $cred
Get-VMHost
Get-VM
Disconnect-VIServer -Confirm:$false

Les objets de l'inventaire ont les identifiants et les noms que la console affiche. Les privilèges du compte s'appliquent à chaque cmdlet.

Cmdlets vérifiées

Ces cmdlets ont été exécutées avec Kyvernon sans modification de leurs paramètres. La liste complète avec le résultat de chacune figure dans outils vérifiés.

DomaineCmdlets
ConnexionConnect-VIServer, Disconnect-VIServer, les informations About du serveur
InventaireGet-Datacenter, Get-Cluster, Get-VMHost, Get-Datastore, Get-VirtualPortGroup, Get-ResourcePool, Get-Folder, Get-VM, Get-Template, Get-View d'un hôte
Machines virtuellesNew-VM, Set-VM (CPU, mémoire, notes), Start-VM, Stop-VM (forcé), Remove-VM, New-VM -VM (clone), Set-VM -ToTemplate, Set-Template -ToVM
MatérielGet-NetworkAdapter, New-NetworkAdapter, Get-HardDisk, New-HardDisk, New-CDDrive, New-AdvancedSetting (configuration supplémentaire)
InstantanésNew-Snapshot, Get-Snapshot, Set-VM -Snapshot (restauration), Remove-Snapshot
DossiersNew-Folder, Remove-Folder
StatistiquesGet-Stat pour les machines virtuelles et les hôtes
Événements et tâchesGet-VIEvent, Get-Task
Rôles et autorisationsGet-VIRole, Get-VIPermission
ÉtiquettesNew-TagCategory, Get-TagCategory, New-Tag, Get-Tag, New-TagAssignment, Get-TagAssignment, Remove-TagAssignment, Remove-Tag, Remove-TagCategory

Limites connues

Aucune opération de la vérification enregistrée n'a échoué. L'ensemble des cmdlets est limité par les méthodes que Kyvernon sert : une cmdlet qui a besoin d'une autre méthode échoue avec une erreur NotSupported. Deux exemples :

  • Stop-VMGuest et Restart-VMGuest appellent ShutdownGuest et RebootGuest, qui ne sont pas servies. Utilisez Stop-VM, ou kyvernon vm shutdown <id> pour un arrêt propre.
  • Les cmdlets des commutateurs distribués et des licences appellent des méthodes qui ne sont pas servies.

La liste des méthodes servies figure dans méthodes de l'API vSphere prises en charge.

Version 0.1. Dernière modification : 2026-11-13