Kyvernon

Werkwijze Voor: ontwikkelaars

PowerCLI

PowerCLI verbinden met de controller, de cmdlets die tegen Kyvernon zijn geverifieerd en de bekende lacunes.

PowerCLI maakt verbinding met het SOAP-endpoint van de controller en, voor tags, met de tokenservice en het REST-endpoint. De vastgelegde verificatie gebruikte PowerShell 7.6.9 met VMware.PowerCLI 13.3.0.24145083.

Voordat u begint

  • Schakel de compatibiliteitsendpoints in: Instellingen van de compatibiliteitsendpoints.
  • Gebruik de naam of het adres van de controller, poort 8443, en het account van een Kyvernon-gebruiker.
  • De controller gebruikt een certificaat dat PowerCLI standaard niet kent. Vertrouw het certificaat op de machine waarop PowerCLI draait. Voor een test kunt u het voor de sessie accepteren met -InvalidCertificateAction Ignore. Achter een proxy met een ander certificaat stelt u trust_certificate_file in op de controller, omdat PowerCLI de tokenservice vastzet op het certificaat dat de lookupservice publiceert.

Met de 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

De objecten van de inventaris hebben de id's en namen die de console toont. De bevoegdheden van het account gelden voor elke cmdlet.

Geverifieerde cmdlets

Deze cmdlets zijn tegen Kyvernon uitgevoerd zonder wijziging van hun parameters. De volledige lijst met het resultaat van elke cmdlet staat in geverifieerde tools.

OnderdeelCmdlets
VerbindingConnect-VIServer, Disconnect-VIServer, de About-informatie van de server
InventarisGet-Datacenter, Get-Cluster, Get-VMHost, Get-Datastore, Get-VirtualPortGroup, Get-ResourcePool, Get-Folder, Get-VM, Get-Template, Get-View van een host
Virtuele machinesNew-VM, Set-VM (CPU, geheugen, notities), Start-VM, Stop-VM (hard), Remove-VM, New-VM -VM (klonen), Set-VM -ToTemplate, Set-Template -ToVM
HardwareGet-NetworkAdapter, New-NetworkAdapter, Get-HardDisk, New-HardDisk, New-CDDrive, New-AdvancedSetting (extra configuratie)
SnapshotsNew-Snapshot, Get-Snapshot, Set-VM -Snapshot (terugzetten), Remove-Snapshot
MappenNew-Folder, Remove-Folder
StatistiekenGet-Stat voor virtuele machines en hosts
Gebeurtenissen en takenGet-VIEvent, Get-Task
Rollen en machtigingenGet-VIRole, Get-VIPermission
TagsNew-TagCategory, Get-TagCategory, New-Tag, Get-Tag, New-TagAssignment, Get-TagAssignment, Remove-TagAssignment, Remove-Tag, Remove-TagCategory

Bekende lacunes

Geen bewerking van de vastgelegde verificatie is mislukt. De set cmdlets wordt beperkt door de methoden die Kyvernon aanbiedt, dus een cmdlet die een andere methode nodig heeft, mislukt met een NotSupported-fout. Twee voorbeelden:

  • Stop-VMGuest en Restart-VMGuest roepen ShutdownGuest en RebootGuest aan, die niet worden aangeboden. Gebruik Stop-VM, of kyvernon vm shutdown <id> voor een nette afsluiting.
  • Cmdlets voor distributed switches en licenties roepen methoden aan die niet worden aangeboden.

De lijst van aangeboden methoden staat in ondersteunde methoden van de vSphere-API.

Versie 0.1. Laatst gewijzigd: 2026-11-13