cv4pve-api-powershell
Proxmox VE PowerShell module for accessing API like VMware PowerCLI
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Corsinvest/cv4pve-api-powershell with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Corsinvest/cv4pve-api-powershell'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/corsinvest--cv4pve-api-powershell)HTML
<a href="/listings/corsinvest--cv4pve-api-powershell"><img src="/api/listings/corsinvest--cv4pve-api-powershell/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install-Module -Name Corsinvest.ProxmoxVE.Api -Scope CurrentUser # connect to any node of the cluster, with an API token Connect-PveCluster -HostsAndPorts pve01 -ApiToken 'automation@pve!ps=<secret>' # every VM and container of the cluster Get-PveGuest | Format-Table vmid, name, node, type, status # the generated cmdlets return the data in .Response.data (Get-PveNodesQemuConfig -Node pve01 -Vmid 100).Response.data
Requires PowerShell 7. With a self-signed certificate add `-SkipCertificateCheck`. What the token needs: [Permissions](https://corsinvest.github.io/cv4pve-api-powershell/permissions/).
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 128 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # <img src="icon.png" alt="" height="36" align="top"> cv4pve-api-powershell
- ```
- ______ _ __
- / ____/___ __________(_)___ _ _____ _____/ /_
- / / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
- / /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
- \____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
- PowerShell for Proxmox VE (Made in Italy)
- ```
- [](LICENSE)
- [](https://www.powershellgallery.com/packages/Corsinvest.ProxmoxVE.Api/)
- [](https://www.powershellgallery.com/packages/Corsinvest.ProxmoxVE.Api/)
- > **The PowerCLI for Proxmox VE**: a PowerShell module with a cmdlet for every endpoint of the Proxmox VE API, running on your machine and talking only to the API.
- >
- > **[Documentation](https://corsinvest.github.io/cv4pve-api-powershell/)**
- ---
- <p align="center">
- <img src="images/powershell.png" alt="PowerShell holding a shield with the Proxmox logo" width="320">
- </p>
- ## Why
- The Proxmox VE web interface is made for one action at a time. Snapshot forty VMs before an update, list every VM with its disks for an audit, clone a template ten times, shut down a lab every evening: by hand it is slow and error-prone.
- VMware administrators have PowerCLI for this. cv4pve-api-powershell is the same idea for Proxmox VE: the whole API as PowerShell cmdlets, so your scripts, scheduled tasks and habits keep working: objects in the pipeline, `Where-Object`, `Export-Csv`, `Get-Help`.
- It **runs on your machine and uses only the Proxmox VE API**: nothing to install on the nodes, no SSH.
- ---
- ## Features
- - **The whole API**: one cmdlet per endpoint and method, generated from the Proxmox VE API, with its parameters, types and allowed values.
- - **VMs by id or name**: `Get-PveGuest` finds VMs and containers by id, name, range, node, pool or tag, with exclusions; the same selection starts, stops or snapshots them all in one call.
- - **API token or password**: list several nodes and the first that answers is used.
- - **Objects, not text**: the Proxmox VE data as PowerShell objects, with the HTTP outcome beside it.
- - **Tasks**: start a backup, clone or migration and wait for it to finish, with a progress bar if you like.
- - **Anything else**: `Invoke-PveRestApi` calls any path of the API with the same connection.
- - **`-WhatIf` and `-Confirm`**: on every cmdlet that changes something, to see what would be done before doing it; without them nothing asks, as scripts expect.
- - **Cross-platform**: PowerShell 7 on Windows, Linux and macOS.
- ---
- ## Quick start
- ```powershell
- Install-Module -Name Corsinvest.ProxmoxVE.Api -Scope CurrentUser
- # connect to any node of the cluster, with an API token
- Connect-PveCluster -HostsAndPorts pve01 -ApiToken 'automation@pve!ps=<secret>'
- # every VM and container of the cluster
- Get-PveGuest | Format-Table vmid, name, node, type, status
- # the generated cmdlets return the data in .Response.data
- (Get-PveNodesQemuConfig -Node pve01 -Vmid 100).Response.data
- ```
- Requires PowerShell 7. With a self-signed certificate add `-SkipCertificateCheck`. What the token needs: [Permissions](https://corsinvest.github.io/cv4pve-api-powershell/permissions/).
- ---
- ## What it looks like
- ```powershell
- PS> Get-PveGuest | Format-Table vmid, name, node, type, status
- vmid name node type status
- ---- ---- ---- ---- ------
- 105 test pve01 lxc stopped
- 1006 dc01 pve01 qemu running
- 100 backup01 pve02 lxc running
- 102 firewall02 pve02 qemu running
- 1012 mailstore pve02 qemu running
- PS> Get-PveNode | Select-Object node, status, @{ n = 'cpu%'; e = { [math]::Round($_.cpu * 100, 1) } }
- node status cpu%
- ---- ------ ----
- pve02 online 1.50
- pve01 online 4.20
- ```
- `Get-PveGuest` returns the guests themselves; the generated cmdlets return a `PveResponse` with the data in `.Response.data`. More recipes, each with its output: [Common tasks](https://corsinvest.github.io/cv4pve-api-powershell/examples/common-tasks/).
- ---
- ## Documentation
- | | |
- |---|---|
- | [Getting started](https://corsinvest.github.io/cv4pve-api-powershell/getting-started/) | Install, connect, first cmdlets |
- | [Connection](https://corsinvest.github.io/cv4pve-api-powershell/connection/) | API token or password, several nodes, certificates, permissions |
- | [Coming from PowerCLI](https://corsinvest.github.io/cv4pve-api-powershell/coming-from-powercli/) | Each PowerCLI cmdlet mapped to its equivalent, and what works differently |
- | [Concepts](https://corsinvest.github.io/cv4pve-api-powershell/concepts/results/) | Results, parameters, tasks, errors, raw API calls |
- | [Guides](https://corsinvest.github.io/cv4pve-api-powershell/guides/finding-vms/) | VMs by id or name, power, snapshots, SPICE |
- | [Examples](https://corsinvest.github.io/cv4pve-api-powershell/examples/common-tasks/) | Common tasks with their output, inventory to CSV, creating VMs, guest agent, backups |
- | [Cmdlet reference](https://corsinvest.github.io/cv4pve-api-powershell/reference/) | Every cmdlet with its endpoint and parameters |
- | [AI assistants](https://corsinvest.github.io/cv4pve-api-powershell/ai-agents/) | Claude Code, Codex, the `cv4pve-api-powershell` skill |
- | [Troubleshooting](https://corsinvest.github.io/cv4pve-api-powershell/troubleshooting/) | `-Debug` and the common errors |
- ---
- ## Related tools
- Prefer the command line in any shell? [cv4pve-cli](https://github.com/Corsinvest/cv4pve-cli) calls the same API. From .NET: [cv4pve-api-dotnet](https://github.com/Corsinvest/cv4pve-api-dotnet). The whole suite: [corsinvest.it/cv4pve](https://www.corsinvest.it/en/cv4pve/).
- ---
- ## Support
- Professional support and consulting available through [Corsinvest](https://www.corsinvest.it/en/cv4pve/).
- ---
- **By sysadmins, for sysadmins.**
- Part of [cv4pve](https://www.corsinvest.it/en/cv4pve/) suite | Made with ❤️ in Italy by [Corsinvest](https://www.corsinvest.it)
- Proxmox® is a registered trademark of Proxmox Server Solutions GmbH. cv4pve is developed by Corsinvest and is not a Proxmox product.
- Copyright © Corsinvest Srl
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.