Skip to content
PowerShell Module for VMware Cloud Foundation
Branch: master
Clone or download
PowerVCF Merge pull request #42 from PowerVCF/dev-39-gb-missing-return-validat…

$response return on Validate functions
Latest commit f2d2d31 Jan 23, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
SampleJSON VCFTask Doc Updates Jan 13, 2020
docs Merge pull request #40 from PowerVCF/dev-39-gb-reset-vcfhost Jan 22, 2020
.gitignore Ignore Mac file Jan 21, 2020 Update Jan 14, 2020
powerVCF.psd1 update branch Nov 7, 2019
powerVCF.psm1 Merge pull request #42 from PowerVCF/dev-39-gb-missing-return-validat… Jan 22, 2020


PowerVCF is a PowerShell Module for interacting with the VMware Cloud Foundation (SDDC Manager) public API.

VMware Cloud Foundation Product Documentation

VMware Cloud Foundation API Documentation


This is not an officially supported VMware PowerShell Module. It was initially developed and maintained by Brian O'Connell who is a Staff Architect in the VMware HCI Business Unit (HCIBU).

The purpose of this module is to make VMware Cloud Foundation API more accessible to fans of PowerCli and drive adoption of the VMware Cloud Foundation API & VMware Cloud Foundation in general. It is provided without warranty and should not be used in a production environment without thoroughly testing first. It has been developed against VMware Cloud Foundation 3.9 and best efforts will be made to validate all cmdlets against future VMware Cloud Foundation versions but no promises!


If you would like to contribute please get in touch! Current contributors listed below.

Brian O'Connell - VMware HCI BU Staff Architect [Twitter] [Blog]

Gary Blake - VMware HCI BU Staff II Architect [Twitter] [Blog]

Giuliano Bertello - Dell EMC Sr. Principal Engineer Solutions Architecture [Twitter] [Blog]

Supported Platforms

This version has been tested using vSAN Ready Nodes. VMware Cloud Foundation on VxRail has not been fully tested, The following cmdlets will not work with VxRail as the workflow is different due to the use of VxRail Manager. Other cmdlets may work subject to testing.



All Network pool actions

New/Set/Remove Workload domains

Installing the module

Tested in Windows PowerShell 5.x & PowerShell Core 6.x

To install the module from the PowerShell Gallery Open PowerShell as Administrator and run the following

Install-Module -Name PowerVCF

Alternatively to manually install the module download the full module zip from the GitHub repo, extract and run the following in PowerShell

Import-Module .\PowerVCF

Getting Started

All API operations must currently be authenticated using the SDDC Manager admin account. To create a base64 credential to authenticate each cmdlet you must first run:

Connect-VCFManager -fqdn sddc-manager.sfo01.rainpole.local -username admin -password VMware1!

Note: -username & -password are optional. If not passed a credential window will be presented.

Authentication is only valid for the duration of the PowerShell session.

Managing Credentials (password retrieval/update/rotation) requires dual authentication using a privileged username & password. See here for setup instructions:


Get a list of VCF Hosts


Sample Output

id             : 3fc04947-64c9-4402-8970-be93169140c6
esxiVersion    : 6.7.0-13981272
fqdn           : sfo01m01esx01.sfo01.rainpole.local
hardwareVendor : Dell Inc.
hardwareModel  : PowerEdge R640
ipAddresses    : {@{ipAddress=; type=MANAGEMENT}, @{ipAddress=; type=VSAN},
                 @{ipAddress=; type=VMOTION}}
cpu            : @{frequencyMHz=61455.61328125; cores=28; cpuCores=System.Object[]}
memory         : @{totalCapacityMB=261761.34375}
storage        : @{totalCapacityMB=10988496; disks=System.Object[]}
domain         : @{id=fbdcf199-c086-43aa-9071-5d53b5c5b99d}
cluster        : @{id=a511b625-8eb8-417e-85f0-5b47ebb4c0f1}
status         : ASSIGNED

Responses can be filtered like this:

Get-VCFHost -id 3fc04947-64c9-4402-8970-be93169140c6 | Select esxiVersion

Or like this:

$hostDetail = Get-VCFHost -id edc4f372-aab5-4906-b6d8-9b96d3113304

Get Help

For a full list of supported cmdlets run the following

Get-Command -Module powerVCF

All cmdlets support the following

Get-Help cmdlet-name

Get-Help cmdlet-name -examples

Get-Help cmdlet-name -detailed

Get-Help cmdlet-name -full


PowerVCF Documentation

You can’t perform that action at this time.