Add PAIF-N automation example (#629)

* Adding PAIF-N demo scripts

* Removing Confidential from headers

* Addressing review comments

---------

Co-authored-by: Lyuboslav Asenov <lasenov@vmware.com>

.gitignore

@@ -5,6 +5,7 @@
 
 #VS Code Files
 *.vscode
+/.vs
 
 # Windows image file caches
 Thumbs.db
@@ -48,4 +49,5 @@ $RECYCLE.BIN/
 .AppleDesktop
 Network Trash Folder
 Temporary Items
-.apdisk
+.apdisk
+/Modules/VMware.vSphere.SsoAdmin/ForPSGallery/VMware.vSphere.SsoAdmin

LICENSE.md

@@ -1,42 +0,0 @@
-# PowerCLI-Example-Scripts
-VMWARE TECHNOLOGY PREVIEW LICENSE AGREEMENT
-
-Notice to User: This Technology Preview License Agreement (the “Agreement”) is a CONTRACT between you (either an individual or a single entity) (“you” or “Licensee”) and VMware, Inc. (“VMware”), which covers your use of the Technology Preview Software (as defined below). If you do not agree to the terms of this Agreement, then do not install or use the Technology Preview Software. By explicitly accepting this Agreement, however, or by installing, copying, downloading, accessing, or otherwise using the Technology Preview Software, you are acknowledging and agreeing to be bound by the following terms.
-
-1.	DEFINITIONS. (a)  “Technology Preview Software” means the unreleased, concept version of VMware’s software, in object form only, excluding any Open Source Software provided with the such software, and the media and Documentation provided by VMware to Licensee and for which Licensee is granted a use license pursuant to this Agreement.  (b)  “Documentation” means the printed and online written reference material furnished to Licensee in conjunction with the Technology Preview Software, including, without limitation, instructions, testing guidelines, and end user guides.  (c)  “Intellectual Property Rights” shall mean all intellectual property rights, including, without limitation, patent, copyright, trademark, and trade secret.  (d)  “Open Source Software” means various open source software components provided with the Technology Preview Software that are licensed to you under the terms of the applicable license agreements included with such open source software components or other materials for the Technology Preview Software.   (e)  “Updates” means a modification, error correction, bug fix, new release, or other update to or for the Technology Preview Software.
-
-2.	LICENSE GRANT, USE AND OWNERSHIP.
-
-       (a)  Limited License.  Subject to the terms and conditions of this Agreement, VMware grants to Licensee a non-exclusive, non-transferable license (without the right to sublicense) (i) to use the Technology Preview Software in accordance with the Documentation solely for purposes of internal testing and evaluation, (ii) to use the Documentation provided with the Technology Preview Software in support of Licensee’s authorized use of the Technology Preview Software, and (iii) to copy the Technology Preview Software for archival or backup purposes, provided that all titles and trademarks, copyright, and restricted rights notices are reproduced on such copies.  
-
-	(b) Evaluation Feedback. The purpose of this limited license is the testing and evaluation of the Technology Preview Software as set forth above.  In furtherance of this purpose, Licensee shall provide feedback to VMware concerning the functionality and performance of the Technology Preview Software from time to time as reasonably requested by VMware, including, without limitation, identifying potential errors and improvements.  Licensee will provide the requested feedback in a manner that is convenient to Licensee subject to reasonable availability of Licensee’s personnel.  Notwithstanding the foregoing, prior to Licensee disclosing to VMware any information under this Agreement that Licensee considers proprietary or confidential, Licensee shall obtain VMware’s prior written approval to disclose such information to VMware, and without such prior written approval from VMware, Licensee shall not disclose any such information to VMware.  VMware may use feedback to improve or enhance its products and, accordingly, you hereby grant to VMware a non-exclusive, perpetual, irrevocable, royalty-free, transferable, worldwide right and license, with the right to sublicense, to use, reproduce, disclose, distribute, perform, display, modify, prepare derivative works of and otherwise exploit the feedback and other information without restriction in any manner now known or in the future conceived and to make, use, sell, offer to sell, import and export any product or service that incorporates the feedback and other information.
-       
-       (c)  Restrictions. Licensee shall not copy or use the Technology Preview Software (including the Documentation) except as expressly permitted in this Agreement.  Except to the extent that any applicable mandatory laws prevent VMware restraining Licensee from doing so, Licensee will not, and will not permit any third party to, sublicense, rent, copy, modify, create derivative works of, translate, reverse engineer, decompile, disassemble, or otherwise reduce to human perceivable form any portion of the Technology Preview Software or accompanying Documentation.  Without limiting the generality of the foregoing, Licensee shall not use the Technology Preview Software for Licensee’s product development or any other commercial purpose.  The Technology Preview Software and all performance data and test results, including without limitation, benchmark test results (collectively “Performance Data”)  relating to the Technology Preview Software are the Confidential Information of VMware, and will be treated in accordance with the terms of Section 4 of this Agreement.  Accordingly, Licensee shall not publish or disclose to any third party any Performance Data relating to the Technology Preview Software.     
-
-       (d)  Ownership.  VMware shall own and retain all right, title and interest in and to the Intellectual Property Rights in the Technology Preview Software, subject only to the limited license expressly set forth in Section 2(a) hereof.  Licensee does not acquire any other rights, express or implied, in the Technology Preview Software.  ALL RIGHTS NOT EXPRESSLY GRANTED HEREUNDER ARE RESERVED TO VMWARE. 
-       
-	(e)  No Support Services.  VMware is under no obligation to support the Technology Preview Software in any way or to provide any Updates to Licensee.  In the event VMware, in its sole discretion, supplies any Update to Licensee, the Update shall be deemed Technology Preview Software under this Agreement and shall be subject to the terms and conditions of this Agreement.
-
-	(f)  Third-Party Software.  The Technology Preview Software may enable a computer to run multiple instances of third-party guest operating systems and application programs.  Licensee acknowledges that Licensee is responsible for obtaining any licenses necessary to operate any third-party software, including guest operating systems and application programs.
-       
-       (g)  Open Source Software.  Except for Sections 5, 6 and 7, the terms and conditions of this Agreement shall not apply to any Open Source Software accompanying the Technology Preview Software.  Any such Open Source Software is provided under the terms of the open source license agreement or copyright notice accompanying such Open Source Software or in the open source licenses file accompanying the Technology Preview Software. 
-       
-3. TERM AND TERMINATION.  Licensee’s rights with respect to the Technology Preview Software will terminate upon the earlier of (a) automatic expiration of the Technology Preview Software based on the system date, or (b) termination by VMware, in its sole discretion, of Licensee’s rights with respect to the Technology Preview Software provided under this Agreement upon notice on the VMware website. Upon any expiration or termination of rights with respect to the Technology Preview Software under this Agreement, the rights and licenses granted to Licensee under this Agreement shall immediately terminate, and Licensee shall immediately cease using, and will destroy or render practically inaccessible the Technology Preview Software, Documentation, and all other tangible items in Licensee’s possession or control that contain Confidential Information.  The rights and obligations of the parties set forth in Sections 2(b), 2(c), 2(d), 2(e), 2(f), 2(g), 3, 4, 5, 6 and 7 shall survive termination or expiration of this Agreement for any reason.
-
-4.	CONFIDENTIALITY.  (a)  Confidentiality.  "Confidential Information" means the Technology Preview Software, all information regarding the Technology Preview Software (including any trade secrets, know-how, inventions, techniques, processes, and algorithms embodied in the Technology Preview Software), Documentation, Performance Data, any Updates, and other information provided by VMware to Licensee under this Agreement, whether disclosed orally, in writing, or by examination or inspection, other than information that Licensee can demonstrate (i) was already known to Licensee, other than under an obligation of confidentiality, at the time of disclosure; (ii) was generally available in the public domain at the time of disclosure to Licensee; (iii) became generally available in the public domain after disclosure other than through any act or omission of Licensee; (iv) was subsequently lawfully disclosed to Licensee by a third party without any obligation of confidentiality; or (v) was independently developed by Licensee without use of or reference to any information or materials disclosed by VMware or its suppliers.  If Licensee is required to disclose Confidential Information by applicable law or court order, Licensee shall notify VMware of the required disclosure promptly in writing and shall cooperate with VMware in any lawful action to contest or limit the scope of the required disclosure.  Confidential Information shall include, without limitation, any information relating to VMware products, product roadmaps, and other technical, business, financial and product development plans, forecasts and strategies.  Licensee shall not use any Confidential Information for any purpose other than as expressly authorized under this Agreement.  In no event shall Licensee use the Technology Preview Software or any Confidential Information to develop, manufacture, market, sell, or distribute any product or service, including any VMware products.  Licensee shall not disclose any Confidential Information to any third party. Without limiting the foregoing, Licensee shall use at least the same degree of care that it uses to prevent the disclosure of its own confidential information of like importance, but in no event less than reasonable care, to prevent the disclosure of such Confidential Information.   (b)  Additional Confidentiality Restrictions for Highly Confidential Technology Preview Software.  For certain Technology Preview Software designated by VMware as highly confidential (“Highly Confidential Technology Preview Software”) in VMware’s correspondence to you regarding this Technology Preview Software or in any Documentation, additional heightened confidentiality restrictions designated below will apply.  (i)  	Licensee shall limit dissemination of Highly Confidential Technology Preview Software and related information concerning product features, future technologies and roadmaps only to Information Technology teams and/or software/solutions development teams of Licensee designated by VMware, and only to individuals on those teams who have a need to know the Confidential Information for purposes expressly authorized under this Agreement.  For clarity and without limiting the generality of the foregoing, Licensee shall not disseminate any Highly Confidential Technology Preview Software to Licensee's sales and marketing field organizations.  Licensee will assign an employee who will be primarily responsible (“Primary Contact”) for ensuring that the terms of this Agreement are complied with.   (ii)	 Licensee acknowledges that damages for improper disclosure of Highly Confidential Technology Preview Software or related information concerning product features, future technologies and roadmaps may be irreparable and that monetary damages would be inadequate to compensate VMware for any breach of this Agreement.  In the event that VMware reasonably believes that Licensee has disseminated certain of such Highly Confidential Technology Preview Software or related information concerning product features, future technologies and roadmaps to an unauthorized party, Licensee will be immediately removed from VMware’s Technology Preview Software program and will not be permitted to participate in any VMware Technology Preview Software program in the future.  Additionally, all rights and licenses granted to Licensee under this Agreement shall immediately terminate in accordance with Section 3 herein (Term and Termination).   (c) Remedies.  In addition to all other remedies available in law or otherwise, VMware is entitled to seek equitable relief, including injunctive relief, against the threatened breach of this Agreement or the continuation of any such breach.
-
-5.	LIMITATION OF LIABILITY.  IT IS UNDERSTOOD THAT THE TECHNOLOGY PREVIEW SOFTWARE IS PROVIDED WITHOUT CHARGE FOR LIMITED EVALUATION PURPOSES.  ACCORDINGLY, THE TOTAL LIABILITY OF VMWARE AND ITS LICENSORS ARISING OUT OF OR RELATED TO THIS AGREEMENT SHALL NOT EXCEED US$100.00.  TO THE FULLEST EXTENT PERMITTED BY LAW, IN NO EVENT SHALL VMWARE OR ITS LICENSORS HAVE LIABILITY FOR ANY INDIRECT, INCIDENTAL, PUNITIVE, SPECIAL, OR CONSEQUENTIAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY (INCLUDING WITHOUT LIMITATION, TORT, STATUTE, CONTRACT OR OTHER), EVEN IF VMWARE AND ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY. 
-
-6.	WARRANTY DISCLAIMER.  IT IS UNDERSTOOD THAT THE TECHNOLOGY PREVIEW SOFTWARE, OPEN SOURCE SOFTWARE, DOCUMENTATION, AND ANY UPDATES MAY CONTAIN ERRORS AND ARE PROVIDED FOR LIMITED EVALUATION ONLY.  THE TECHNOLOGY PREVIEW SOFTWARE, THE OPEN SOURCE SOFTWARE, THE DOCUMENTATION, AND ANY UPDATES ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, WHETHER EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE.  VMWARE AND ITS LICENSORS SPECIFICALLY DISCLAIM ALL IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.  Licensee acknowledges that VMware has not publicly announced the availability of the Technology Preview Software, that such Technology Preview Software may contain features currently under development, that VMware has not promised or guaranteed to Licensee that such Technology Preview Software will be announced or made available to anyone in the future, that VMware has no express or implied obligation to Licensee to announce or introduce the Technology Preview Software, that VMware has no obligation to introduce a product similar to or compatible with the Technology Preview Software, and that any version number (if any) referenced is subject to change and does not in any way represent VMware’s commitment to release any product in the future. Accordingly, Licensee acknowledges that any research or development that it performs regarding the Technology Preview Software or any product associated with the Technology Preview Software is done entirely at Licensee’s own risk.  Specifically, the Technology Preview Software may contain features, functionality or modules that will not be included in the production version of the Technology Preview Software, if released, or that will be marketed separately for additional fees.
-
-7.	OTHER PROVISIONS.  (a)  Governing Law.  This Agreement, and all disputes arising out of or related thereto, shall be governed by and construed under the laws of the State of California without reference to conflict of laws principles.  All such disputes shall be subject to the exclusive jurisdiction of the state and federal courts located in Santa Clara County, California, and the parties agree and submit to the personal and exclusive jurisdiction and venue of these courts.  The United Nations Convention for the International Sale of Goods shall not apply.  (b) Export Control.  The Technology Preview Software is of United States origin and is provided subject to the U.S. Export Administration Regulations.  Diversion contrary to U.S. law is prohibited.  Without limiting the foregoing, you agree that (i) you are not, and are not acting on behalf of, any person who is a citizen, national, or resident of, or who is controlled by the government of, Cuba, Iran, North Korea, Sudan, or Syria, or any other country to which the United States has prohibited export transactions; (ii) you are not, and are not acting on behalf of, any person or entity listed on the U.S. Treasury Department list of Specially Designated Nationals and Blocked Persons, or the U.S. Commerce Department Denied Persons List or Entity List; and (iii) you will not use the Technology Preview Software for, and will not permit the Technology Preview Software to be used for, any purposes prohibited by law, including, without limitation, for any prohibited development, design, manufacture or production of missiles or nuclear, chemical or biological weapons. U.S. Export Control Classification Numbers (ECCN’s) may be found at VMware help page: http://www.vmware.com/help/export-control.   (c)  Modification.  This is the entire agreement between the parties relating to the subject matter hereof and all other terms are rejected.  No waiver or modification of this Agreement shall be valid unless in writing signed by each party.  The waiver of a breach of any term hereof shall in no way be construed as a waiver of any other term or breach hereof.  If any provision of this Agreement is held by a court of competent jurisdiction to be contrary to law, the remaining provisions of this Agreement shall remain in full force and effect.  (d)  Data Privacy.  Licensee agrees that VMware may process technical and related usage information about Licensee’s use of the Technology Preview Software for statistical and analytical purposes. Usage information is collected strictly for internal statistical and analytical purposes for the development of VMware products and services. Licensee understands that any log files generated in order to obtain support from VMware may contain sensitive, confidential or personal information. Licensee should consider obfuscating any logs before sending them to VMware.  VMware’s privacy policy (http://www.vmware.com/help/privacy.html) shall apply.
-
-8.	ASSIGNMENT.  Licensee shall not assign this Agreement or any rights or obligations hereunder, directly or indirectly, by operation of law, merger, acquisition of stock or assets, or otherwise, without the prior written consent of VMware.  Any attempted assignment or transfer in violation of the foregoing will be null and void.  Subject to the foregoing, this Agreement shall inure to the benefit of and be binding upon the parties and their respective successors and permitted assigns.
-
-9. 	CONTACT INFORMATION.  If you have any questions about this Agreement, please direct all correspondence to: VMware, Inc., 3401 Hillview Avenue, Palo Alto, CA 94304, United States of America or email info@vmware.com.  VMware is a trademark of VMware, Inc. and is registered in the U.S. and numerous other countries.	
-
-Rev. 2014Mar10
-		
-
-
-

LICENSE.txt

@@ -0,0 +1,12 @@
+PowerCLI-Example-Scripts
+Copyright 2021 VMware, Inc.
+
+BSD 2-Clause License
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Modules/Backup-VCSA/Backup-VCSA.psm1

@@ -1,204 +1,554 @@
-Function Backup-VCSAToFile {
 <#
-    .NOTES
-    ===========================================================================
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Backup-VCSAToFile {
+<#
+	.NOTES
+	===========================================================================
 	 Created by:   	Brian Graf
-     Date:          October 30, 2016
+	 Date:          October 30, 2016
 	 Organization: 	VMware
-     Blog:          www.vtagion.com
-     Twitter:       @vBrianGraf
+	 Blog:          www.vtagion.com
+	 Twitter:       @vBrianGraf
+	 Modifed by:    Michael Dunsdon
+	 Twitter:       @MJDunsdon
+	 Date:          September 21, 2020
 	===========================================================================
 
 	.SYNOPSIS
 		This function will allow you to create a full or partial backup of your
-    VCSA appliance. (vSphere 6.5 and higher)
-	
+		VCSA appliance. (vSphere 6.5 and higher)
 	.DESCRIPTION
 		Use this function to backup your VCSA to a remote location
-
 	.EXAMPLE
-        [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword = "VMw@re123"
-        $Comment = "First API Backup"
-        $LocationType = "FTP"
-        $location = "10.144.99.5/vcsabackup-$((Get-Date).ToString('yyyy-MM-dd-hh-mm'))"
-        $LocationUser = "admin"
-        [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$locationPassword = "VMw@re123"
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword = "VMw@re123"
+		$Comment = "First API Backup"
+		$LocationType = "FTP"
+		$location = "10.144.99.5/vcsabackup-$((Get-Date).ToString('yyyy-MM-dd-hh-mm'))"
+		$LocationUser = "admin"
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$locationPassword = "VMw@re123"
 		PS C:\> Backup-VCSAToFile -BackupPassword $BackupPassword  -LocationType $LocationType -Location $location -LocationUser $LocationUser -LocationPassword $locationPassword -Comment "This is a demo" -ShowProgress -FullBackup
-
-	
 	.NOTES
-        Credit goes to @AlanRenouf for sharing the base of this function with me which I was able to take and make more robust as well as add in progress indicators
-        You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentials
+		Credit goes to @AlanRenouf for sharing the base of this function with me which I was able to take and make more robust as well as add in progress indicators
+		You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentials
+		A CisService can also be supplied as a parameter.
 		If a -LocationType is not chosen, the function will default to FTP.
-        The destination location for a backup must be an empty folder (easiest to use the get-date cmdlet in the location)
-        -ShowProgress will give you a progressbar as well as updates in the console
-        -CommonBackup will only backup the config whereas -Fullbackup grabs the historical data as well
+		The destination location for a backup must be an empty folder (easiest to use the get-date cmdlet in the location)
+		-ShowProgress will give you a progressbar as well as updates in the console
+		-CommonBackup will only backup the config whereas -Fullbackup grabs the historical data as well
 #>
-    param (
-        [Parameter(ParameterSetName=’FullBackup’)]
-        [switch]$FullBackup,
-        [Parameter(ParameterSetName=’CommonBackup’)]
-        [switch]$CommonBackup,
-        [ValidateSet('FTPS', 'HTTP', 'SCP', 'HTTPS', 'FTP')]
-        $LocationType = "FTP",
-        $Location,
-        $LocationUser,
-        [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$LocationPassword,
-        [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword,
-        $Comment = "Backup job",
-        [switch]$ShowProgress
-    )
-    Begin {
-        if (!($global:DefaultCisServers)){ 
-            Add-Type -Assembly System.Windows.Forms
-            [System.Windows.Forms.MessageBox]::Show("It appears you have not created a connection to the CisServer. You will now be prompted to enter your vCenter credentials to continue" , "Connect to CisServer") | out-null
-            $Connection = Connect-CisServer $global:DefaultVIServer 
-        } else {
-            $Connection = $global:DefaultCisServers
-        }
-        if ($FullBackup) {$parts = @("common","seat")}
-        if ($CommonBackup) {$parts = @("common")}
-    }
-    Process{
-        $BackupAPI = Get-CisService com.vmware.appliance.recovery.backup.job
-        $CreateSpec = $BackupAPI.Help.create.piece.CreateExample()
-        $CreateSpec.parts = $parts
-        $CreateSpec.backup_password = $BackupPassword
-        $CreateSpec.location_type = $LocationType
-        $CreateSpec.location = $Location
-        $CreateSpec.location_user = $LocationUser
-        $CreateSpec.location_password = $LocationPassword
-        $CreateSpec.comment = $Comment
-        try {
-            $BackupJob = $BackupAPI.create($CreateSpec)
-        }
-        catch {
-            throw $_.Exception.Message
-        }
-            
+	param (
+		[Parameter(ParameterSetName='FullBackup')]
+		[switch]$FullBackup,
+		[Parameter(ParameterSetName='CommonBackup')]
+		[switch]$CommonBackup,
+		[ValidateSet('FTPS', 'HTTP', 'SCP', 'HTTPS', 'FTP', 'SMB', 'SFTP')]
+		$LocationType = "FTP",
+		$Location,
+		$LocationUser,
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$LocationPassword,
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword,
+		$Comment = "Backup job",
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers,
+		[switch]$ShowProgress
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+		if ($FullBackup) {$parts = @("common","seat")}
+		if ($CommonBackup) {$parts = @("common")}
 
-        If ($ShowProgress){
-            do {
-                $BackupAPI.get("$($BackupJob.ID)") | select id, progress, state
-                $progress = ($BackupAPI.get("$($BackupJob.ID)").progress)
-                Write-Progress -Activity "Backing up VCSA"  -Status $BackupAPI.get("$($BackupJob.ID)").state -PercentComplete ($BackupAPI.get("$($BackupJob.ID)").progress) -CurrentOperation "$progress% Complete"
-                start-sleep -seconds 5
-            } until ($BackupAPI.get("$($BackupJob.ID)").progress -eq 100 -or $BackupAPI.get("$($BackupJob.ID)").state -ne "INPROGRESS")
-
-            Write-Progress -Activity "Backing up VCSA" -Completed
-            $BackupAPI.get("$($BackupJob.ID)") | select id, progress, state
-        } 
-        Else {
-            $BackupJob | select id, progress, state
-        }
-    }
-    End {}
+		# Per github issue 468 (https://github.com/vmware/PowerCLI-Example-Scripts/issues/468) adding some logic to account for SFTP/SCP handling in versions after VC 7.0.
+		$vCenterVersionNumber = (Get-CisService -Name 'com.vmware.appliance.system.version').get().version
+		if ( ($vCenterVersionNumber -ge 6.5 -AND $vCenterVersionNumber -lt 7.0 ) -AND $LocationType -eq 'SFTP' )  {
+			write-warning 'VCSA Backup for versions 6.5 and 6.7 use SCP, not SFTP.  Adjusting the LocationType accordingly.'
+			$LocationType = 'SCP'
+		} 
+		if ( $vCenterVersionNumber -ge 7.0 -AND $LocationType -eq 'SCP' ) {
+			write-warning 'VCSA Backup starting with version 7.0 use SFTP and not SCP.  Adjusting the LocationType accordingly.'
+			$LocationType = 'SFTP'
+		}
+	}
+	Process{
+		$BackupAPI = Get-CisService 'com.vmware.appliance.recovery.backup.job'
+		$CreateSpec = $BackupAPI.Help.create.piece.CreateExample()
+		$CreateSpec.parts = $parts
+		$CreateSpec.backup_password = $BackupPassword
+		$CreateSpec.location_type = $LocationType
+		$CreateSpec.location = $Location
+		$CreateSpec.location_user = $LocationUser
+		$CreateSpec.location_password = $LocationPassword
+		$CreateSpec.comment = $Comment
+		try {
+			$BackupJob = $BackupAPI.create($CreateSpec)
+		} catch {
+			throw $_.Exception.Message
+		}
+		If ($ShowProgress){
+			do {
+				$BackupAPI.get("$($BackupJob.ID)") | Select-Object id, progress, state
+				$progress = ($BackupAPI.get("$($BackupJob.ID)").progress)
+				Write-Progress -Activity "Backing up VCSA"  -Status $BackupAPI.get("$($BackupJob.ID)").state -PercentComplete ($BackupAPI.get("$($BackupJob.ID)").progress) -CurrentOperation "$progress% Complete"
+				Start-Sleep -seconds 5
+			} until ($BackupAPI.get("$($BackupJob.ID)").progress -eq 100 -or $BackupAPI.get("$($BackupJob.ID)").state -ne "INPROGRESS")
+			Write-Progress -Activity "Backing up VCSA" -Completed
+			$BackupAPI.get("$($BackupJob.ID)") | Select-Object id, progress, state
+		} Else {
+			$BackupJob | Select-Object id, progress, state
+		}
+	}
+	End {}
 }
 
 Function Get-VCSABackupJobs {
 <#
-    .NOTES
-    ===========================================================================
-	 Created by:   	Brian Graf
-     Date:          October 30, 2016
-	 Organization: 	VMware
-     Blog:          www.vtagion.com
-     Twitter:       @vBrianGraf
+	.NOTES
+	===========================================================================
+	 Created by:    Brian Graf
+	 Date:          October 30, 2016
+	 Organization:  VMware
+	 Blog:          www.vtagion.com
+	 Twitter:       @vBrianGraf
+	 Modifed by:    Michael Dunsdon
+	 Twitter:       @MJDunsdon
+	 Date:          September 21, 2020
 	===========================================================================
 
 	.SYNOPSIS
 		Get-VCSABackupJobs returns a list of all backup jobs VCSA has ever performed (vSphere 6.5 and higher)
-	
 	.DESCRIPTION
 		Get-VCSABackupJobs returns a list of all backup jobs VCSA has ever performed
-
 	.EXAMPLE
 		PS C:\> Get-VCSABackupJobs
-	
+	.EXAMPLE
+		PS C:\> Get-VCSABackupJobs -ShowNewest -CisServer "vcserver.sphere.local"
 	.NOTES
 		The values returned are read as follows:
-        YYYYMMDD-hhmmss-vcsabuildnumber
-        You can pipe the results of this function into the Get-VCSABackupStatus function
-        Get-VCSABackupJobs | select -First 1 | Get-VCSABackupStatus <- Most recent backup
+		YYYYMMDD-hhmmss-vcsabuildnumber
+		You can pipe the results of this function into the Get-VCSABackupStatus function
+		Get-VCSABackupJobs | select -First 1 | Get-VCSABackupStatus <- Most recent backup
 #>
-    param (
-        [switch]$ShowNewest
-    )
-    Begin {
-        if (!($global:DefaultCisServers)){ 
-            [System.Windows.Forms.MessageBox]::Show("It appears you have not created a connection to the CisServer. You will now be prompted to enter your vCenter credentials to continue" , "Connect to CisServer") | out-null
-            $Connection = Connect-CisServer $global:DefaultVIServer 
-        } else {
-            $Connection = $global:DefaultCisServers
-        }
-    }
-    Process{
-       
-        $BackupAPI = Get-CisService com.vmware.appliance.recovery.backup.job
-
-        try {
-            if ($ShowNewest) {
-                $results = $BackupAPI.list()
-                $results[0]
-            } else {
-                $BackupAPI.list()
-            }
-        }
-        catch {
-            Write-Error $Error[0].exception.Message
-        }
-
-        }
-
-    End {}
+	param (
+		[Parameter(Mandatory=$false)][switch]$ShowNewest,
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		$BackupAPI = Get-CisService 'com.vmware.appliance.recovery.backup.job'
+		try {
+			if ($ShowNewest) {
+				$results = $BackupAPI.list()
+				$results[0]
+			} else {
+				$BackupAPI.list()
+			}
+		} catch {
+			Write-Error $Error[0].exception.Message
+		}
+	}
+	End {}
 }
 
 Function Get-VCSABackupStatus {
 <#
-    .NOTES
-    ===========================================================================
-	 Created by:   	Brian Graf
-     Date:          October 30, 2016
-	 Organization: 	VMware
-     Blog:          www.vtagion.com
-     Twitter:       @vBrianGraf
+	.NOTES
+	===========================================================================
+	 Created by:    Brian Graf
+	 Date:          October 30, 2016
+	 Organization:  VMware
+	 Blog:          www.vtagion.com
+	 Twitter:       @vBrianGraf
+	 Modifed by:    Michael Dunsdon
+	 Twitter:       @MJDunsdon
+	 Date:          September 21, 2020
 	===========================================================================
 
 	.SYNOPSIS
 		Returns the ID, Progress, and State of a VCSA backup (vSphere 6.5 and higher)
-	
 	.DESCRIPTION
 		Returns the ID, Progress, and State of a VCSA backup
-
-	.EXAMPLE
+ 	.EXAMPLE
 		PS C:\> $backups = Get-VCSABackupJobs
-                $backups[0] | Get-VCSABackupStatus
-	
+				$backups[0] | Get-VCSABackupStatus
 	.NOTES
 		The BackupID can be piped in from the Get-VCSABackupJobs function and can return multiple job statuses
 #>
-    Param (
-        [parameter(ValueFromPipeline=$True)]
-        [string[]]$BackupID
-    )
- Begin {
-        if (!($global:DefaultCisServers)){ 
-            [System.Windows.Forms.MessageBox]::Show("It appears you have not created a connection to the CisServer. You will now be prompted to enter your vCenter credentials to continue" , "Connect to CisServer") | out-null
-            $Connection = Connect-CisServer $global:DefaultVIServer 
-        } else {
-            $Connection = $global:DefaultCisServers
-        }
-        
-        $BackupAPI = Get-CisService com.vmware.appliance.recovery.backup.job
- }
-    Process{
-       
-        foreach ($id in $BackupID) {
-            $BackupAPI.get("$id") | select id, progress, state
-        }
-        
-
-    }
-
-    End {}
+	Param (
+		[parameter(Mandatory=$false,ValueFromPipeline=$True)][string[]]$BackupID,
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		$BackupAPI = Get-CisService 'com.vmware.appliance.recovery.backup.job'
+		Foreach ($id in $BackupID) {
+			$BackupAPI.get("$id") | Select-Object id, progress, state
+		}
+	}
+	End {}
+}
+
+Function New-VCSASchedule {
+<#
+	.NOTES
+	===========================================================================
+	 Original Created by:  Brian Graf
+	 Blog:                 www.vtagion.com
+	 Twitter:              @vBrianGraf
+	 Organization:         VMware
+	 Created / Modifed by: Michael Dunsdon
+	 Twitter:              @MJDunsdon
+	 Date:                 September 21, 2020
+	===========================================================================
+
+	.SYNOPSIS
+		This function will allow you to create a scheduled to backup your
+		VCSA appliance. (vSphere 6.7 and higher)
+	.DESCRIPTION
+		Use this function to create a schedule to backup your VCSA to a remote location
+	.EXAMPLE
+		The Below Create a schedule on Monday @11:30pm to FTP location 10.1.1.10:/vcsabackup/vcenter01
+		and keep 4 backups with a Encryption Passowrd of "VMw@re123"
+
+		$location = "ftp://10.1.1.10/vcsabackup/vcenter01"
+		$LocationUser = "admin"
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$locationPassword = "VMw@re123"
+		$BHour = 23
+		$BMin = 30
+		$BDays = @("Monday")
+		$MaxCount = 4
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword = "VMw@re123"
+
+		PS C:\> New-VCSASchedule -Location $location -LocationUser $LocationUser -LocationPassword $locationPassword -BackupHour $BHour -BackupMinute $BMin -backupDays $BDays -MaxCount $MaxCount -BackupPassword $BackupPassword
+	.EXAMPLE
+		The Below Create a schedule on Sunday & Wednesday @5:15am
+		to NFS location 10.1.1.10:/vcsabackup/vcenter01
+		keep 10 backups with a Encryption Passowrd of "VMw@re123"
+		with Event Data included (Seat) and will delete any existing schedule.
+
+		$location = "nfs://10.1.1.10/vcsabackup/vcenter01"
+		$LocationUser = "admin"
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$locationPassword = "VMw@re123"
+		$BHour = 5
+		$BMin = 15
+		$BDays = @("Sunday", "Monday")
+		$MaxCount = 10
+		[VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword = "VMw@re123"
+
+		PS C:\> New-VCSASchedule -IncludeSeat -force -Location $location -LocationUser $LocationUser -LocationPassword $locationPassword -BackupHour $BHour -BackupMinute $BMin -backupDays $BDays -MaxCount $MaxCount -BackupPassword $BackupPassword -CisServer "vcserver.sphere.local"
+	.NOTES
+		Credit goes to @AlanRenouf & @vBrianGraf for sharing the base of this function.
+		You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentials
+#>
+	[CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]
+	param (
+		[Parameter(Mandatory=$true)]$Location,
+		[Parameter(Mandatory=$true)]$LocationUser,
+		[Parameter(Mandatory=$true)][VMware.VimAutomation.Cis.Core.Types.V1.Secret]$LocationPassword,
+		[Parameter(Mandatory=$false)][VMware.VimAutomation.Cis.Core.Types.V1.Secret]$BackupPassword,
+		[Parameter(Mandatory=$true)][ValidateRange(0,23)]$BackupHour,
+		[Parameter(Mandatory=$true)][ValidateRange(0,59)]$BackupMinute,
+		[Parameter(Mandatory=$true)][ValidateSet('MONDAY', 'TUESDAY', 'WEDNESDAY', 'THURSDAY', 'FRIDAY', 'SATURDAY', 'SUNDAY', IgnoreCase = $False)][Array]$BackupDays = $null,
+		[Parameter(Mandatory=$true)][Int]$MaxCount,
+		[Parameter(Mandatory=$false)]$BackupID = "default",
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers,
+		[Parameter(Mandatory=$false)][switch]$IncludeSeat,
+		[Parameter(Mandatory=$false)][switch]$Force
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		if (!(Test-VCSAScheduleSupport)) {
+			Write-Error "This VCSA does not support Backup Schedules."
+			return
+		}
+		$BackupAPI = Get-CisService -name 'com.vmware.appliance.recovery.backup.schedules'
+		$CreateSpec = $BackupAPI.Help.create.spec.Create()
+		$CreateSpec.backup_password = $BackupPassword
+		$CreateSpec.location = $Location
+		$CreateSpec.location_user = $LocationUser
+		$CreateSpec.location_password = $LocationPassword
+		$CreateSpec.Enable = $true
+		$CreateSpec.recurrence_info.Hour = $BackupHour
+		$CreateSpec.recurrence_info.Minute = $BackupMinute
+		$CreateSpec.recurrence_info.Days = $BackupDays
+		$CreateSpec.retention_info.max_count = $MaxCount
+		if ($IncludeSeat) {
+			$CreateSpec.parts = @("seat","common")
+		} else {
+			$CreateSpec.parts = @("common")
+		}
+		$CurrentSchedule = $BackupAPI.list()
+
+
+		if ($CurrentSchedule.keys.value) {
+			if($Force -or $PSCmdlet.ShouldContinue($CurrentSchedule.keys.value,'Delete Old Schedule')){
+				$BackupAPI.delete($CurrentSchedule.keys.value)
+			} else {
+				Write-Error "There is an exisiting Schedule. Please delete before Creating a new one."
+				return
+			}
+		}
+		if ($PSCmdlet.ShouldProcess($BackupID, 'Create New Schedule.')) {
+			try {
+				$BackupJob = $BackupAPI.create($BackupID, $CreateSpec)
+			}
+			catch {
+				throw $_.Exception.Message
+			}
+		}
+		if ($BackupJob) {
+			Write-Host "Backup up Job Created."
+			return $BackupJob
+		}
+	}
+	End {}
+}
+
+Function Get-VCSASchedule {
+<#
+	.NOTES
+	===========================================================================
+	 Original Created by:  Brian Graf
+	 Blog:                 www.vtagion.com
+	 Twitter:              @vBrianGraf
+	 Organization:         VMware
+	 Created / Modifed by: Michael Dunsdon
+	 Twitter:              @MJDunsdon
+	 Date:                 September 21, 2020
+	===========================================================================
+
+	.SYNOPSIS
+		This function will allow you to Get the scheduled backup of your
+		VCSA appliance. (vSphere 6.7 and higher)
+	.DESCRIPTION
+		Use this function to Get the backup schedule for your VCSA appliance.
+	.EXAMPLE
+		PS C:\> Get-VCSASchedule
+	.EXAMPLE
+		PS C:\> Get-VCSASchedule -ScheduleID 1 -CisServer "vcserver.sphere.local"
+	.NOTES
+		Credit goes to @AlanRenouf & @vBrianGraf for sharing the base of this function.
+		Returns a simplified object with the schedule details.
+		You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentials
+#>
+	param (
+		[Parameter(Mandatory=$False,HelpMessage="Will Filter List By ScheduleID")]$ScheduleID,
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		if (!(Test-VCSAScheduleSupport)) {
+			Write-Error "This VCSA does not support Backup Schedules."
+			return
+		}
+		$BackupAPI = Get-CisService -name 'com.vmware.appliance.recovery.backup.schedules'
+		$Schedules = $BackupAPI.list()
+		if ($Schedules.count -ge 1) {
+			$ObjSchedule = @()
+			foreach ($Schedule in $Schedules) {
+				$ObjSchedule += $Schedule.values | Select-Object *,@{N = "ID"; e = {"$($schedule.keys.value)"}} -ExpandProperty recurrence_info -ExcludeProperty Help | Select-Object * -ExcludeProperty recurrence_info,Help | Select-Object * -ExpandProperty retention_info | Select-Object * -ExcludeProperty retention_info,Help
+			}
+			if ($ScheduleID) {
+				$ObjSchedule = $ObjSchedule | Where-Object {$_.ID -eq $ScheduleID}
+			}
+			return $ObjSchedule
+		} else {
+			Write-Information "No Schedule Defined."
+		}
+	}
+	End {}
+}
+
+Function Remove-VCSASchedule {
+<#
+	.NOTES
+	===========================================================================
+	 Original Created by:  Brian Graf
+	 Blog:                 www.vtagion.com
+	 Twitter:              @vBrianGraf
+	 Organization:         VMware
+	 Created / Modifed by: Michael Dunsdon
+	 Twitter:              @MJDunsdon
+	 Date:                 September 21, 2020
+	============================================================================
+ 	.SYNOPSIS
+		This function will remove any scheduled backups of your
+		VCSA appliance. (vSphere 6.7 and higher)
+	.DESCRIPTION
+		Use this function to remove the backup schedule for your VCSA appliance.
+	.EXAMPLE
+		PS C:\> Remove-VCSASchedule
+	.EXAMPLE
+		PS C:\> Remove-VCSASchedule -ScheduleID 1 -CisServer "vcserver.sphere.local"
+	.NOTES
+		Credit goes to @AlanRenouf & @vBrianGraf for sharing the base of this function.
+		You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentials
+#>
+	[CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
+	param (
+		[Parameter(Mandatory=$false)]$ScheduleID = "default",
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		if (!(Test-VCSAScheduleSupport)) {
+			Write-Error "This VCSA does not support Backup Schedules."
+			return
+		}
+		if ($PSCmdlet.ShouldProcess($ScheduleID, "Removes Current Backup Schedule")) {
+			$BackupAPI = Get-CisService -name 'com.vmware.appliance.recovery.backup.schedules'
+			$BackupAPI.delete($ScheduleID)
+		}
+	}
+	End {}
+}
+
+Function Test-VCSAScheduleSupport {
+<#
+	.NOTES
+	===========================================================================
+	 Original Created by:  Brian Graf
+	 Blog:                 www.vtagion.com
+	 Twitter:              @vBrianGraf
+	 Organization:         VMware
+	 Created / Modifed by: Michael Dunsdon
+	 Twitter:              @MJDunsdon
+	 Date:                 September 21, 2020
+	===========================================================================
+	.SYNOPSIS
+		This function will check to see if your VCSA supports Scheduled Backups.
+		(vSphere 6.7 and higher)
+	.DESCRIPTION
+		Use this function to check if your VCSA supports Scheduled Backups.
+	.EXAMPLE
+		PS C:\> Test-VCSAScheduleSupport
+	.EXAMPLE
+		PS C:\> Test-VCSAScheduleSupport -CisServer "vcserver.sphere.local"
+	.NOTES
+		Credit goes to @AlanRenouf & @vBrianGraf for sharing the base of this function.
+		You must be connected to the CisService for this to work, if you are not connected, the function will prompt you for your credentia
+#>
+	param (
+		[Parameter(Mandatory=$false)]$CisServer = $global:DefaultCisServers
+	)
+	Begin {
+		if ($CisServer.IsConnected) {
+			Write-Verbose "Connected to $($CisServer.Name)"
+			$connection = $CisServer
+		} elseif ($CisServer.gettype().name -eq "String") {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($CisServer)."
+			$Connection = Connect-CisServer $CisServer
+		} elseif ($global:DefaultCisServers) {
+			$connection = $global:DefaultCisServers
+		} elseif ($global:DefaultVIServer) {
+			Write-Host "Prompting for CIS Server credentials. Connecting to $($global:DefaultVIServer.name)."
+			$Connection = Connect-CisServer $global:DefaultVIServer
+		}
+		if (!$Connection) {
+			Write-Error "It appears you have not created a connection to the CisServer. Please Connect First and try command again. (Connect-CisServer)"
+		}
+	}
+	Process{
+		if ((Get-CisService).name -contains "com.vmware.appliance.recovery.backup.schedules" ) {
+			Write-Verbose "This VCSA does supports Backup Schedules."
+			return $true
+		} else {
+			Write-Verbose "This VCSA does not support Backup Schedules."
+			return $false
+		}
+	}
+	End {}
 }

Modules/ContentLibrary/ContentLibrary.psm1

@@ -1,11 +1,15 @@
-Function Get-ContentLibrary {
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Get-ContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function lists all available vSphere Content Libaries
@@ -20,12 +24,12 @@
         [Parameter(Mandatory=$false)][String]$LibraryName
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $LibraryIDs = $contentLibraryService.list()
 
     $results = @()
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryID)
+    foreach($libraryID in $LibraryIDs) {
+        $library = $contentLibraryService.get($libraryID)
 
         # Use vCenter REST API to retrieve name of Datastore that is backing the Content Library
         $datastoreService = Get-CisService com.vmware.vcenter.datastore
@@ -87,10 +91,10 @@ Function Get-ContentLibraryItems {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function lists all items within a given vSphere Content Library
@@ -108,18 +112,18 @@ Function Get-ContentLibraryItems {
         [Parameter(Mandatory=$false)][String]$LibraryItemName
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $LibraryIDs = $contentLibraryService.list()
 
     $results = @()
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryId)
+    foreach($libraryID in $LibraryIDs) {
+        $library = $contentLibraryService.get($libraryId)
         if($library.name -eq $LibraryName) {
-            $contentLibaryItemService = Get-CisService com.vmware.content.library.item
-            $itemIds = $contentLibaryItemService.list($libraryID)
+            $contentLibraryItemService = Get-CisService com.vmware.content.library.item
+            $itemIds = $contentLibraryItemService.list($libraryID)
 
             foreach($itemId in $itemIds) {
-                $item = $contentLibaryItemService.get($itemId)
+                $item = $contentLibraryItemService.get($itemId)
 
                 if(!$LibraryItemName) {
                     $itemResult = [pscustomobject] @{
@@ -158,10 +162,10 @@ Function Get-ContentLibraryItemFiles {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function lists all item files within a given vSphere Content Library
@@ -179,28 +183,40 @@ Function Get-ContentLibraryItemFiles {
         [Parameter(Mandatory=$false)][String]$LibraryItemName
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $libraryIDs = $contentLibraryService.list()
 
     $results = @()
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryId)
+    foreach($libraryID in $libraryIDs) {
+        $library = $contentLibraryService.get($libraryId)
         if($library.name -eq $LibraryName) {
-            $contentLibaryItemService = Get-CisService com.vmware.content.library.item
-            $itemIds = $contentLibaryItemService.list($libraryID)
+            $contentLibraryItemService = Get-CisService com.vmware.content.library.item
+            $itemIds = $contentLibraryItemService.list($libraryID)
+            $DatastoreID = $library.storage_backings.datastore_id.Value
+            $Datastore = get-datastore -id "Datastore-$DatastoreID"
 
             foreach($itemId in $itemIds) {
-                $itemName = ($contentLibaryItemService.get($itemId)).name
-                $contenLibraryItemFileSerice = Get-CisService com.vmware.content.library.item.file
-                $files = $contenLibraryItemFileSerice.list($itemId)
+                $itemName = ($contentLibraryItemService.get($itemId)).name
+                $contentLibraryItemFileSerice = Get-CisService com.vmware.content.library.item.file
+                $files = $contentLibraryItemFileSerice.list($itemId)
+                $contentLibraryItemStorageService = Get-CisService com.vmware.content.library.item.storage
 
                 foreach($file in $files) {
+                    if($contentLibraryItemStorageService.get($itemId, $($file.name)).storage_backing.type -eq "DATASTORE"){
+                        $filepath = $contentLibraryItemStorageService.get($itemId, $($file.name)).storage_uris.segments -notmatch '(^/$|^vmfs$*|^volumes$*|vsan:.*)' -join ''
+                        $fullfilepath = "[$($datastore.name)] $filepath"
+                    }
+                    else{
+                        $fullfilepath = "UNKNOWN"
+                    }
+
                     if(!$LibraryItemName) {
                         $fileResult = [pscustomobject] @{
                             Name = $file.name;
                             Version = $file.version;
                             Size = $file.size;
                             Stored = $file.cached;
+                            Path = $fullfilepath;
                         }
                         $results+=$fileResult
                     } else {
@@ -210,6 +226,7 @@ Function Get-ContentLibraryItemFiles {
                                 Version = $file.version;
                                 Size = $file.size;
                                 Stored = $file.cached;
+                                Path = $fullfilepath;
                             }
                             $results+=$fileResult
                         }
@@ -225,10 +242,10 @@ Function Set-ContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function updates the JSON Persistence property for a given Content Library
@@ -245,12 +262,12 @@ Function Set-ContentLibrary {
         [Parameter(Mandatory=$false)][Switch]$JSONPersistenceDisabled
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $LibraryIDs = $contentLibraryService.list()
 
     $found = $false
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryId)
+    foreach($libraryID in $LibraryIDs) {
+        $library = $contentLibraryService.get($libraryId)
         if($library.name -eq $LibraryName) {
             $found = $true
             break
@@ -281,10 +298,10 @@ Function New-ExtReplicatedContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function creates a new Subscriber Content Library from a JSON Persisted
@@ -331,8 +348,8 @@ Function New-ExtReplicatedContentLibrary {
         $createSpec = $subscribeLibraryService.Help.create.create_spec.Create()
         $createSpec.name = $LibraryName
         $addResults = $createSpec.storage_backings.Add($StorageSpec)
-        $createSpec.subscription_info.automatic_sync_enabled = $false
-        $createSpec.subscription_info.on_demand = $true
+        $createSpec.subscription_info.automatic_sync_enabled = $AutoSync
+        $createSpec.subscription_info.on_demand = $OnDemand
         $createSpec.subscription_info.subscription_url = $subscribeUrl
         $createSpec.subscription_info.authentication_method = "NONE"
         $createSpec.type = "SUBSCRIBED"
@@ -345,10 +362,10 @@ Function Remove-SubscribedContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function deletes a Subscriber Content Library
@@ -361,12 +378,12 @@ Function Remove-SubscribedContentLibrary {
         [Parameter(Mandatory=$true)][String]$LibraryName
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $LibraryIDs = $contentLibraryService.list()
 
     $found = $false
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryId)
+    foreach($libraryID in $LibraryIDs) {
+        $library = $contentLibraryService.get($libraryId)
         if($library.name -eq $LibraryName) {
             $found = $true
             break
@@ -387,10 +404,10 @@ Function New-LocalContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function creates a new Subscriber Content Library from a JSON Persisted
@@ -444,10 +461,10 @@ Function Remove-LocalContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function deletes a Local Content Library
@@ -460,12 +477,12 @@ Function Remove-LocalContentLibrary {
         [Parameter(Mandatory=$true)][String]$LibraryName
     )
 
-    $contentLibaryService = Get-CisService com.vmware.content.library
-    $libaryIDs = $contentLibaryService.list()
+    $contentLibraryService = Get-CisService com.vmware.content.library
+    $LibraryIDs = $contentLibraryService.list()
 
     $found = $false
-    foreach($libraryID in $libaryIDs) {
-        $library = $contentLibaryService.get($libraryId)
+    foreach($libraryID in $LibraryIDs) {
+        $library = $contentLibraryService.get($libraryId)
         if($library.name -eq $LibraryName) {
             $found = $true
             break
@@ -486,56 +503,56 @@ Function Copy-ContentLibrary {
 <#
     .NOTES
     ===========================================================================
-     Created by:    William Lam
-     Organization:  VMware
-     Blog:          www.virtuallyghetto.com
-     Twitter:       @lamw
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
     ===========================================================================
     .DESCRIPTION
         This function copies all library items from one Content Library to another
-    .PARAMETER SourceLibaryName
+    .PARAMETER SourceLibraryName
         The name of the source Content Library to copy from
-    .PARAMETER DestinationLibaryName
+    .PARAMETER DestinationLibraryName
         The name of the desintation Content Library to copy to
     .PARAMETER DeleteSourceFile
         Whther or not to delete library item from the source Content Library after copy
     .EXAMPLE
-        Copy-ContentLibrary -SourceLibaryName Foo -DestinationLibaryName Bar
+        Copy-ContentLibrary -SourceLibraryName Foo -DestinationLibraryName Bar
     .EXAMPLE
-        Copy-ContentLibrary -SourceLibaryName Foo -DestinationLibaryName Bar -DeleteSourceFile $true
+        Copy-ContentLibrary -SourceLibraryName Foo -DestinationLibraryName Bar -DeleteSourceFile $true
 #>
     param(
-        [Parameter(Mandatory=$true)][String]$SourceLibaryName,
-        [Parameter(Mandatory=$true)][String]$DestinationLibaryName,
+        [Parameter(Mandatory=$true)][String]$SourceLibraryName,
+        [Parameter(Mandatory=$true)][String]$DestinationLibraryName,
         [Parameter(Mandatory=$false)][Boolean]$DeleteSourceFile=$false
     )
 
-    $sourceLibraryId = (Get-ContentLibrary -LibraryName $SourceLibaryName).Id
+    $sourceLibraryId = (Get-ContentLibrary -LibraryName $SourceLibraryName).Id
     if($sourceLibraryId -eq $null) {
-        Write-Host -ForegroundColor red "Unable to find Source Content Library named $SourceLibaryName"
+        Write-Host -ForegroundColor red "Unable to find Source Content Library named $SourceLibraryName"
         exit
     }
-    $destinationLibraryId = (Get-ContentLibrary -LibraryName $DestinationLibaryName).Id
+    $destinationLibraryId = (Get-ContentLibrary -LibraryName $DestinationLibraryName).Id
     if($destinationLibraryId -eq $null) {
-        Write-Host -ForegroundColor Red "Unable to find Destination Content Library named $DestinationLibaryName"
+        Write-Host -ForegroundColor Red "Unable to find Destination Content Library named $DestinationLibraryName"
         break
     }
 
-    $sourceItemFiles = Get-ContentLibraryItems -LibraryName $SourceLibaryName
+    $sourceItemFiles = Get-ContentLibraryItems -LibraryName $SourceLibraryName
     if($sourceItemFiles -eq $null) {
-        Write-Host -ForegroundColor red "Unable to retrieve Content Library Items from $SourceLibaryName"
+        Write-Host -ForegroundColor red "Unable to retrieve Content Library Items from $SourceLibraryName"
         break
     }
 
-    $contentLibaryItemService = Get-CisService com.vmware.content.library.item
+    $contentLibraryItemService = Get-CisService com.vmware.content.library.item
 
     foreach ($sourceItemFile in  $sourceItemFiles) {
         # Check to see if file already exists in destination Content Library
-        $result = Get-ContentLibraryItems -LibraryName $DestinationLibaryName -LibraryItemName $sourceItemFile.Name
+        $result = Get-ContentLibraryItems -LibraryName $DestinationLibraryName -LibraryItemName $sourceItemFile.Name
 
         if($result -eq $null) {
             # Create CopySpec
-            $copySpec = $contentLibaryItemService.Help.copy.destination_create_spec.Create()
+            $copySpec = $contentLibraryItemService.Help.copy.destination_create_spec.Create()
             $copySpec.library_id = $destinationLibraryId
             $copySpec.name = $sourceItemFile.Name
             $copySpec.description = $sourceItemFile.Description
@@ -545,7 +562,7 @@ Function Copy-ContentLibrary {
             # Perform Copy
             try {
                 Write-Host -ForegroundColor Cyan "Copying" $sourceItemFile.Name "..."
-                $copyResult = $contentLibaryItemService.copy($UniqueChangeId, $sourceItemFile.Id, $copySpec)
+                $copyResult = $contentLibraryItemService.copy($UniqueChangeId, $sourceItemFile.Id, $copySpec)
             } catch {
                 Write-Host -ForegroundColor Red "Failed to copy" $sourceItemFile.Name
                 $Error[0]
@@ -556,7 +573,7 @@ Function Copy-ContentLibrary {
             if($DeleteSourceFile) {
                 try {
                     Write-Host -ForegroundColor Magenta "Deleteing" $sourceItemFile.Name "..."
-                    $deleteResult = $contentLibaryItemService.delete($sourceItemFile.Id)
+                    $deleteResult = $contentLibraryItemService.delete($sourceItemFile.Id)
                 } catch {
                     Write-Host -ForegroundColor Red "Failed to delete" $sourceItemFile.Name
                     $Error[0]
@@ -570,7 +587,7 @@ Function Copy-ContentLibrary {
             if($DeleteSourceFile) {
                 try {
                     Write-Host -ForegroundColor Magenta "Deleteing" $sourceItemFile.Name "..."
-                    $deleteResult = $contentLibaryItemService.delete($sourceItemFile.Id)
+                    $deleteResult = $contentLibraryItemService.delete($sourceItemFile.Id)
                 } catch {
                     Write-Host -ForegroundColor Red "Failed to delete" $sourceItemFile.Name
                     break
@@ -578,4 +595,190 @@ Function Copy-ContentLibrary {
             }
         }
     }
+}
+
+Function New-VMTX {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function clones a VM to VM Template in Content Library (currently only supported on VMC)
+    .PARAMETER SourceVMName
+        The name of the source VM to clone
+    .PARAMETER VMTXName
+        The name of the VM Template in Content Library
+    .PARAMETER Description
+        Description of the VM template
+    .PARAMETER LibraryName
+        The name of the Content Library to clone to
+    .PARAMETER FolderName
+        The name of vSphere Folder (Defaults to Workloads for VMC)
+    .PARAMETER ResourcePoolName
+        The name of the vSphere Resource Pool (Defaults to Compute-ResourcePools for VMC)
+    .EXAMPLE
+        New-VMTX -SourceVMName "Windows10-BaseInstall" -VMTXName "Windows10-VMTX-Template" -LibraryName "VMC-CL-01"
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$SourceVMName,
+        [Parameter(Mandatory=$true)][String]$VMTXName,
+        [Parameter(Mandatory=$false)][String]$Description,
+        [Parameter(Mandatory=$true)][String]$LibraryName,
+        [Parameter(Mandatory=$false)][String]$FolderName="Workloads",
+        [Parameter(Mandatory=$false)][String]$ResourcePoolName="Compute-ResourcePool"
+    )
+
+    $vmtxService = Get-CisService -Name "com.vmware.vcenter.vm_template.library_items"
+
+    $sourceVMId = ((Get-VM -Name $SourceVMName).ExtensionData.MoRef).Value
+    $libraryId = ((Get-ContentLibrary -LibraryName $LibraryName).Id).Value
+    $folderId = ((Get-Folder -Name $FolderName).ExtensionData.MoRef).Value
+    $rpId = ((Get-ResourcePool -Name $ResourcePoolName).ExtensionData.MoRef).Value
+
+    $vmtxCreateSpec =  $vmtxService.Help.create.spec.Create()
+    $vmtxCreateSpec.source_vm = $sourceVMId
+    $vmtxCreateSpec.name = $VMTXName
+    $vmtxCreateSpec.description = $Description
+    $vmtxCreateSpec.library = $libraryId
+    $vmtxCreateSpec.placement.folder = $folderId
+    $vmtxCreateSpec.placement.resource_pool = $rpId
+
+    Write-Host "`nCreating new VMTX Template from $SourceVMName in Content Library $LibraryName ..."
+    $result = $vmtxService.create($vmtxCreateSpec)
+}
+
+Function New-VMFromVMTX {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function deploys a new VM from Template in Content Library (currently only supported in VMC)
+    .PARAMETER VMTXName
+        The name of the VM Template in Content Library to deploy from
+    .PARAMETER NewVMName
+        The name of the new VM to deploy
+    .PARAMETER FolderName
+        The name of vSphere Folder (Defaults to Workloads for VMC)
+    .PARAMETER ResourcePoolName
+        The name of the vSphere Resource Pool (Defaults to Compute-ResourcePools for VMC)
+    .PARAMETER NumCpu
+        The number of vCPU to configure for the new VM
+    .PARAMETER MemoryMb
+        The amount of memory (MB) to configure for the new VM
+    .PARAMETER PowerOn
+        To power on the VM after deploy
+    .EXAMPLE
+        New-VMFromVMTX -NewVMName "FooFoo" -VMTXName "FooBar" -PowerOn $true -NumCpu 4 -MemoryMB 2048
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$VMTXName,
+        [Parameter(Mandatory=$true)][String]$NewVMName,
+        [Parameter(Mandatory=$false)][String]$FolderName="Workloads",
+        [Parameter(Mandatory=$false)][String]$ResourcePoolName="Compute-ResourcePool",
+        [Parameter(Mandatory=$false)][String]$DatastoreName="WorkloadDatastore",
+        [Parameter(Mandatory=$false)][Int]$NumCpu,
+        [Parameter(Mandatory=$false)][Int]$MemoryMB,
+        [Parameter(Mandatory=$false)][Boolean]$PowerOn=$false
+    )
+
+    $vmtxService = Get-CisService -Name "com.vmware.vcenter.vm_template.library_items"
+    $vmtxId = (Get-ContentLibraryItem -Name $VMTXName).Id
+    $folderId = ((Get-Folder -Name $FolderName).ExtensionData.MoRef).Value
+    $rpId = ((Get-ResourcePool -Name $ResourcePoolName).ExtensionData.MoRef).Value
+    $datastoreId = ((Get-Datastore -Name $DatastoreName).ExtensionData.MoRef).Value
+
+    $vmtxDeploySpec =  $vmtxService.Help.deploy.spec.Create()
+    $vmtxDeploySpec.name = $NewVMName
+    $vmtxDeploySpec.powered_on = $PowerOn
+    $vmtxDeploySpec.placement.folder = $folderId
+    $vmtxDeploySpec.placement.resource_pool = $rpId
+    $vmtxDeploySpec.vm_home_storage.datastore = $datastoreId
+    $vmtxDeploySpec.disk_storage.datastore = $datastoreId
+
+    if($NumCpu) {
+        $vmtxDeploySpec.hardware_customization.cpu_update.num_cpus = $NumCpu
+    }
+    if($MemoryMB) {
+        $vmtxDeploySpec.hardware_customization.memory_update.memory = $MemoryMB
+    }
+
+    Write-Host "`nDeploying new VM $NewVMName from VMTX Template $VMTXName ..."
+    $results = $vmtxService.deploy($vmtxId,$vmtxDeploySpec)
+}
+
+Function New-SubscribedContentLibrary {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Organization:  VMware
+    Blog:          www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function creates a new Subscriber Content Library from Subscription URL
+    .PARAMETER LibraryName
+        The name of the new vSphere Content Library
+    .PARAMETER DatastoreName
+        The name of the vSphere Datastore to store the Content Library
+    .PARAMETER SubscriptionURL
+        The URL of the published Content Library
+    .PARAMETER SubscriptionThumbprint
+        The SSL Thumbprint for the published Content Library
+    .PARAMETER OnDemand
+        Specifies whether content is downloaded on-demand (e.g. no immediately)
+    .PARAMETER AutomaticSync
+        Specifies whether automatic synchronization with the external content library is enabled
+    .EXAMPLE
+        New-SubscribedContentLibrary -LibraryName NestedESXi -DatastoreName vsanDatastore -SubscriptionURL https://download3.vmware.com/software/vmw-tools/lib.json  -SubscriptionThumbprint "7a:c4:08:2d:d3:55:56:af:9f:26:43:65:d0:31:99:0b:d2:f3:d8:69" -AutomaticSync
+    .EXAMPLE
+        New-SubscribedContentLibrary -LibraryName NestedESXi -DatastoreName vsanDatastore -SubscriptionURL https://download3.vmware.com/software/vmw-tools/lib.json -SubscriptionThumbprint "7a:c4:08:2d:d3:55:56:af:9f:26:43:65:d0:31:99:0b:d2:f3:d8:69" -OnDemand
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$LibraryName,
+        [Parameter(Mandatory=$true)][String]$DatastoreName,
+        [Parameter(Mandatory=$true)][String]$SubscriptionURL,
+        [Parameter(Mandatory=$true)][String]$SubscriptionThumbprint,
+        [Parameter(Mandatory=$false)][Switch]$OnDemand,
+        [Parameter(Mandatory=$false)][Switch]$AutomaticSync
+    )
+
+    $datastore = Get-Datastore -Name $DatastoreName
+
+    if($datastore) {
+        $datastoreId = $datastore.ExtensionData.MoRef.Value
+        $subscribeLibraryService = Get-CisService -Name "com.vmware.content.subscribed_library"
+
+        $StorageSpec = [pscustomobject] @{
+                        datastore_id = $datastoreId;
+                        type         = "DATASTORE";
+        }
+
+        $UniqueChangeId = [guid]::NewGuid().tostring()
+
+        $createSpec = $subscribeLibraryService.help.create.create_spec.create()
+        $createSpec.name = $LibraryName
+        $createSpec.type = "SUBSCRIBED"
+        $addResults = $createSpec.storage_backings.Add($StorageSpec)
+
+        if($OnDemand) { $OnDemandFlag = $true } else { $OnDemandFlag = $false }
+        if($AutomaticSync) { $AutomaticSyncFlag = $true } else { $AutomaticSyncFlag = $false }
+        $createSpec.subscription_info.on_demand = $OnDemandFlag
+        $createSpec.subscription_info.automatic_sync_enabled = $AutomaticSyncFlag
+        $createSpec.subscription_info.subscription_url = $SubscriptionURL
+        $createSpec.subscription_info.authentication_method = "NONE"
+        $createSpec.subscription_info.ssl_thumbprint = $SubscriptionThumbprint
+
+        Write-Host "Creating new Subscribed Content Library called $LibraryName ..."
+        $library = $subscribeLibraryService.create($UniqueChangeId, $createSpec)
+    }
 }

Modules/CrossvCentervmotion/XVM.psm1

@@ -0,0 +1,315 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Get-XVCMStatus {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function returns whether Cross vCenter Workload Migration Utility is running or not
+    .EXAMPLE
+        Get-XVCMStatus
+#>
+    $Uri = "http://localhost:8080/api/status" #Updated for 2.0, Old: "http://localhost:8080/api/ping"
+
+    $results = Invoke-WebRequest -Uri $Uri -Method GET -TimeoutSec 5
+
+    if($results.StatusCode -eq 200) {
+        Write-Host -ForegroundColor Green $results.Content
+    } else { Write-Host -ForegroundColor Red "Cross vCenter Workload Migration Utility is probably not running" }
+}
+
+Function Get-XVCMSite {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function returns all registered vCenter Servers
+    .EXAMPLE
+        Get-XVCMSite
+#>
+    $Uri = "http://localhost:8080/api/sites"
+
+    $results = Invoke-WebRequest -Uri $Uri -Method GET
+
+    if($results.StatusCode -eq 200) {
+        ($results.Content | ConvertFrom-Json)|select sitename,hostname,username
+    } else { Write-Host -ForegroundColor Red "Failed to retrieve VC Site Registration details" }
+}
+
+Function New-XVCMSite {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function registers a new vCenter Server endpoint
+    .PARAMETER SiteName
+        The display name for the particular vCenter Server to be registered
+    .PARAMETER VCHostname
+        The Hostname/IP Address of vCenter Server
+    .PARAMETER VCUsername
+        The VC Username of vCenter Server
+    .PARAMETER VCPassword
+        The VC Password of vCenter Server
+    .PARAMETER Insecure
+        Flag to disable SSL Verification checking, useful for lab environments
+    .EXAMPLE
+        New-XVCMSite -SiteName "SiteA" -VCHostname "vcenter65-1.primp-industries.com" -VCUsername "administrator@vsphere.local" -VCPassword "VMware1!" -Insecure
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$SiteName,
+        [Parameter(Mandatory=$true)][String]$VCHostname,
+        [Parameter(Mandatory=$true)][String]$VCUsername,
+        [Parameter(Mandatory=$true)][String]$VCPassword,
+        [Parameter(Mandatory=$false)][Switch]$Insecure
+    )
+
+    $Uri = "http://localhost:8080/api/sites"
+
+    $insecureFlag = $false
+    if($Insecure) {
+        $insecureFlag = $true
+    }
+
+    $body = @{
+        "sitename"=$SiteName;
+        "hostname"=$VCHostname;
+        "username"=$VCUsername;
+        "password"=$VCPassword;
+        "insecure"=$insecureFlag;
+    }
+
+    $body = $body | ConvertTo-Json
+
+    Write-Host -ForegroundColor Cyan "Registering vCenter Server $VCHostname as $SiteName ..."
+    $results = Invoke-WebRequest -Uri $Uri -Method POST -Body $body -ContentType "application/json"
+
+    if($results.StatusCode -eq 200) {
+        Write-Host -ForegroundColor Green "Successfully registered $SiteName"
+    } else { Write-Host -ForegroundColor Red "Failed to register $SiteName" }
+}
+
+Function Remove-XVCMSite {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function removes vCenter Server endpoint
+    .PARAMETER SiteName
+        The name of the registered vCenter Server to remove
+    .EXAMPLE
+        Remove-XVCMSite -SiteName "SiteA"
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$SiteName
+    )
+
+    $Uri = "http://localhost:8080/api/sites/$SiteName"
+
+    Write-Host -ForegroundColor Cyan  "Deleting vCenter Server Site Registerion $SiteName ..."
+    $results = Invoke-WebRequest -Uri $Uri -Method DELETE
+
+    if($results.StatusCode -eq 200) {
+        Write-Host -ForegroundColor Green "Successfully deleted $SiteName"
+    } else { Write-Host -ForegroundColor Red "Failed to deleted $SiteName" }
+}
+
+Function New-XVCMRequest {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function initiates a migration request
+	.PARAMETER opType
+		The type of task, Relocate or Clone
+	.PARAMETER SrcSite
+        The name of the source vCenter Server
+    .PARAMETER DstSite
+        The name of the destination vCenter Server
+    .PARAMETER SrcDatacenter
+        The name of the source vSphere Datacenter
+    .PARAMETER DstDatacenter
+        The name of the destination vSphere Datacenter
+    .PARAMETER DstCluster
+        The name of the destination vSphere Cluster, set to null if DstHost is defined
+    .PARAMETER DstPool
+        The name of the destination vSphere Resource Pool
+    .PARAMETER DstFolder
+        The name of the destination vSphere Folder
+    .PARAMETER DstDatastore
+        The name of the destination Datastore
+	.PARAMETER DstHost
+		The name of the destination host. Set to null if DstCluster is defined
+	.PARAMETER srcVMs
+        List of VMs to migrate
+    .PARAMETER NetworkMapping
+        Hash table of the VM network mappings between your source and destination vCenter Server
+    .EXAMPLE
+        New-XVCMRequest -opType Relocate -SrcSite SiteA -DstSite SiteB `
+            -SrcDatacenter Datacenter-SiteA -DstDatacenter Datacenter-SiteB `
+            -DstCluster $null -DstHost VMhost1.test.lab `
+            -DstDatastore vsanDatastore `
+            -srcVMs @("PhotonOS-01","PhotonOS-02","PhotonOS-03","PhotonOS-04") `
+            -NetworkMapping @{"DVPG-VM Network 1"="DVPG-Internal Network";"DVPG-VM Network 2"="DVPG-External Network"}
+    .EXAMPLE
+        New-XVCMRequest -opType Clone -SrcSite OREGON -DstSite CALIF `
+            -SrcDatacenter SDDC-Datacenter -srcVMs @(“DUDE-ubuntu”) `
+            -DstDatacenter SDDC-Datacenter `
+            -DstCluster "Cluster-1" -DstHost $null `
+            -DstPool Compute-ResourcePool `
+            -DstFolder Workloads `
+            -DstDatastore WorkloadDatastore `
+            -NetworkMapping @{"OREGON-VMs-sddc"="CALIF-sddc-VMs"}
+#>
+    param(
+		[Parameter(Mandatory=$true)][String]$opType, #Added by CPM for 2.0
+        [Parameter(Mandatory=$true)][String]$SrcSite,
+        [Parameter(Mandatory=$true)][String]$DstSite,
+        [Parameter(Mandatory=$true)][String]$SrcDatacenter,
+        [Parameter(Mandatory=$true)][String]$DstDatacenter,
+        [Parameter(Mandatory=$true)][AllowNull()] $DstCluster, #Added [AllowNull()], removed [String] by CPM for 2.0
+        [Parameter(Mandatory=$true)][String]$DstPool,
+        [Parameter(Mandatory=$true)][String]$DstFolder,
+        [Parameter(Mandatory=$true)][String]$DstDatastore,
+		[Parameter(Mandatory=$true)][AllowNull()] $DstHost, #Added by CPM for 2.0
+        [Parameter(Mandatory=$true)][String[]]$srcVMs,
+        [Parameter(Mandatory=$true)][Hashtable]$NetworkMapping
+    )
+
+    $Uri = "http://localhost:8080/api/tasks"
+
+    $body = @{
+        "sourceSite"=$SrcSite;
+        "targetSite"=$DstSite;
+        "sourceDatacenter"=$SrcDatacenter;
+        "targetDatacenter"=$dstDatacenter;
+        "targetPool"=$DstPool;
+        "targetFolder"=$DstFolder;
+        "targetCluster"=$DstCluster;
+        "targetDatastore"=$DstDatastore;
+		"targetHost"=$DstHost; #Added by CPM for 2.0
+        "networkMap"=$NetworkMapping;
+        "vmList"=$srcVMs;
+		"operationType"=$opType; #Added by CPM for 2.0
+    }
+
+    $body = $body | ConvertTo-Json
+
+    Write-Host -ForegroundColor Cyan "Initiating migration request ..."
+    $results = Invoke-WebRequest -Uri $Uri -Method POST -Body $body -ContentType "application/json"
+
+    if($results.StatusCode -eq 200) {
+        $taskId = ($results.Content | ConvertFrom-Json).requestId
+        Write-Host -ForegroundColor Green "Successfully issued migration with TaskID: $taskId"
+    } else { Write-Host -ForegroundColor Red "Failed to initiate migration request" }
+}
+
+Function Get-XVCMTask {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function retrieves either all migration tasks and/or a specific migration task
+    .PARAMETER Id
+        The task ID returned from initiating a migration
+    .EXAMPLE
+        Get-XVCMTask -Id <Task ID>
+#>
+    param(
+        [Parameter(Mandatory=$false)][String]$Id
+    )
+
+    $Uri = "http://localhost:8080/api/tasks"
+
+    if($Id) {
+        $body = @{"requestId"=$Id}
+
+        $results = Invoke-WebRequest -Uri $Uri -Method GET -Body $body -ContentType "application/json"
+    } else {
+        $results = Invoke-WebRequest -Uri $Uri -Method GET
+    }
+
+    if($results.StatusCode -eq 200) {
+        $results.Content | ConvertFrom-Json
+    } else { Write-Host -ForegroundColor Red "Failed to retrieve tasks" }
+}
+
+Function Get-VMNetwork {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .DESCRIPTION
+        This function returns the list of all VM Networks attached to
+        given VMs to help with initiating migration
+    .PARAMETER srcVMs
+        List of VMs to query their current VM Networks
+    .EXAMPLE
+        Get-VMNetwork -srcVMs @("PhotonOS-01","PhotonOS-02","PhotonOS-03","PhotonOS-04")
+#>
+    param(
+        [Parameter(Mandatory=$false)][String[]]$srcVMs
+    )
+
+    if (-not $global:DefaultVIServers) { Write-Host -ForegroundColor red "No vCenter Server Connection found, please connect to your source vCenter Server using Connect-VIServer"; break }
+
+    $results = @()
+    if($srcVMs) {
+        foreach ($srcVM in $srcVMs) {
+            $vm = Get-VM -Name $srcVM
+            $networkDetails = $vm | Get-NetworkAdapter
+            $tmp = [pscustomobject] @{
+                Name = $srcVM;
+                Adapter = $networkDetails.name;
+                Network = $networkDetails.NetworkName;
+            }
+            $results+=$tmp
+        }
+    } else {
+        foreach ($vm in Get-VM) {
+            $networkDetails = $vm | Get-NetworkAdapter
+            $tmp = [pscustomobject] @{
+                Name = $vm.Name;
+                Adapter = $networkDetails.name;
+                Network = $networkDetails.NetworkName;
+            }
+            $results+=$tmp
+        }
+    }
+    $results
+}

Modules/DatastoreFunctions/DatastoreFunctions.psm1

@@ -34,7 +34,7 @@ Function Get-HostViews {
 			Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
 		}
 		$allHosts = @()
-		$DShostsKeys = $allDatastores.extensiondata.host.key.value | sort | get-unique -asstring
+		$DShostsKeys = $allDatastores.extensiondata.host.key.value | sort-object | get-unique -asstring
 		$DShosts = foreach ($thisKey in $DShostsKeys) {($allDatastores.extensiondata.host | ? {$_.key.value -eq $thisKey})[0]}
 		$i = 1
 		foreach ($DSHost in $DSHosts){
@@ -47,7 +47,7 @@ Function Get-HostViews {
 		}
 		write-progress -activity "Collecting ESXi Host Views" -completed
 		$allHosts
-	}           
+	}
 }
 
 Function Get-DatastoreMountInfo {
@@ -74,7 +74,7 @@ Function Get-DatastoreMountInfo {
 			Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
 		}
 		$allDatastoreNAAs = foreach ($ds in $allDatastores) {$ds.ExtensionData.Info.vmfs.extent[0].diskname}
-		
+
 		#Build the array of custom Host Objects
 		$allHosts = Get-HostViews -datastore $allDatastores
 		$output = @()
@@ -89,9 +89,9 @@ Function Get-DatastoreMountInfo {
 					$thisDatastore = $alldatastores | ? {$_.ExtensionData.Info.vmfs.extent[0].diskname -eq $device.canonicalName}
 					$hostviewDSAttachState = ""
 					if ($device.operationalState[0] -eq "ok") {
-						$hostviewDSAttachState = "Attached"						    
+						$hostviewDSAttachState = "Attached"
 					} elseif ($device.operationalState[0] -eq "off") {
-						$hostviewDSAttachState = "Detached"						   
+						$hostviewDSAttachState = "Detached"
 					} else {
 						$hostviewDSAttachState = $device.operationalstate[0]
 					}

Modules/Get-NICDetails/Get-NICDetails.psm1

@@ -1,15 +1,15 @@
 function Get-NICDetails {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
-    2017.02 ver 1.0 Base Release  
+    Changelog:
+    2017.02 ver 1.0 Base Release
     ===========================================================================
-    External Code Sources: 
+    External Code Sources:
     -
     ===========================================================================
     Tested Against Environment:
@@ -35,11 +35,11 @@
 #>
 
 [CmdletBinding()]
-param( 
+param(
     [Parameter(Mandatory=$True, ValueFromPipeline=$False, Position=0)]
     [ValidateNotNullorEmpty()]
         [String] $Clustername
-        
+
 )
 
 Begin {
@@ -49,14 +49,14 @@ Begin {
        $Validate = $False
        thow "No Cluster '$myCluster' found!"
     }
-  
+
 }
 
 Process {
 
     $MyView = @()
     if ($Validate -eq $True) {
-  
+
         foreach ($myVMhost in ($myCluster | Get-VMHost)) {
 
             $esxcli2 = Get-ESXCLI -VMHost $myVMhost -V2
@@ -85,7 +85,7 @@ Process {
 		        }
 
 		}
-        
+
        $MyView
 
     }

Modules/Get-NewAndRemovedVMs/Get-NewAndRemovedVMs.psm1

@@ -1,15 +1,15 @@
 function Get-NewAndRemovedVMs {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
-    2016.12 ver 1.0 Base Release 
+    Changelog:
+    2016.12 ver 1.0 Base Release
     ===========================================================================
-    External Code Sources:  
+    External Code Sources:
     https://github.com/alanrenouf/vCheck-vSphere
     ===========================================================================
     Tested Against Environment:
@@ -22,10 +22,10 @@ function Get-NewAndRemovedVMs {
     ===========================================================================
 
     .DESCRIPTION
-    This Function report newly created and deleted VMs by Cluster.       
+    This Function report newly created and deleted VMs by Cluster.
 
     .Example
-    Get-NewAndRemovedVMs -ClusterName Cluster* | ft -AutoSize  
+    Get-NewAndRemovedVMs -ClusterName Cluster* | ft -AutoSize
 
     .Example
     Get-NewAndRemovedVMs -ClusterName Cluster01 -Days 90
@@ -51,7 +51,7 @@ param(
 )
 Begin {
     function Get-VIEventPlus {
-	 
+
 	param(
 		[VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl[]]$Entity,
 		[string[]]$EventType,
@@ -117,7 +117,7 @@ Begin {
 		{
 			$events | % { $_.createdTime = $_.createdTime.ToLocalTime() }
 		}
-		
+
 		$events
 	}
 }
@@ -125,7 +125,7 @@ Begin {
 
 process {
     $result = Get-VIEventPlus -Start ((get-date).adddays(-$Days)) -EventType @("VmCreatedEvent", "VmBeingClonedEvent", "VmBeingDeployedEvent","VmRemovedEvent")
-    $sortedResult = $result | Select CreatedTime, @{N='Cluster';E={$_.ComputeResource.Name}}, @{Name="VMName";Expression={$_.vm.name}}, UserName, @{N='Type';E={$_.GetType().Name}}, FullFormattedMessage | Sort CreatedTime
-    $sortedResult | where {$_.Cluster -like $ClusterName}
+    $sortedResult = $result | Select-Object CreatedTime, @{N='Cluster';E={$_.ComputeResource.Name}}, @{Name="VMName";Expression={$_.vm.name}}, UserName, @{N='Type';E={$_.GetType().Name}}, FullFormattedMessage
+    $sortedResult | where-object {$_.Cluster -like $ClusterName}
 }
 }

Modules/Get-VMmaxIOPS/Get-VMmaxIOPS.psm1

@@ -1,16 +1,16 @@
 function Get-VMmaxIOPS {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
-    2016.10 ver 1.0 Base Release 
+    Changelog:
+    2016.10 ver 1.0 Base Release
     2016.11 ver 1.1 Added vSphere 6.5 Support, New Counters, More Error Handling
     ===========================================================================
-    External Code Sources:  
+    External Code Sources:
     http://www.lucd.info/2011/04/22/get-the-maximum-iops/
     https://communities.vmware.com/thread/485386
     ===========================================================================
@@ -24,7 +24,7 @@ function Get-VMmaxIOPS {
     ===========================================================================
 
     .DESCRIPTION
-    This Function will Create a VM Disk IOPS Report  
+    This Function will Create a VM Disk IOPS Report
 
     .Example
     Get-VM TST* | Get-VMmaxIOPS -Minutes 60 | FT -Autosize
@@ -34,17 +34,17 @@ function Get-VMmaxIOPS {
     Get-VMmaxIOPS -VMs $SampleVMs -Minutes 60
 
     .PARAMETER VMs
-    Specify the VMs 
+    Specify the VMs
 
 	.PARAMETER Minutes
-    Specify the Minutes to report (10080 is one Week) 
+    Specify the Minutes to report (10080 is one Week)
 
 #Requires PS -Version 4.0
 #Requires -Modules VMware.VimAutomation.Core, @{ModuleName="VMware.VimAutomation.Core";ModuleVersion="6.3.0.0"}
 #>
 
 [CmdletBinding()]
-param( 
+param(
     [Parameter(Mandatory=$true, ValueFromPipeline=$True, Position=0)]
     [ValidateNotNullorEmpty()]
         [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl[]] $VMs,
@@ -55,7 +55,7 @@ param(
 Begin {
     # none
     }
-Process { 
+Process {
        if ($_.PowerState -eq "PoweredOn") {
             #region: Global Definitions
             [int]$TimeRange = "-" + $Minutes
@@ -82,7 +82,7 @@ Process {
 
             #region: Creating Reports
             Write-Verbose "$(Get-Date -Format G) Create Report..."
-            $reportPerf = @() 
+            $reportPerf = @()
             $reportPerf = $stats | Group-Object -Property {$_.Entity.Name},Instance | %{
                 New-Object PSObject -Property @{
                     VM = $_.Values[0]
@@ -98,7 +98,7 @@ Process {
             }
             Write-Verbose "$(Get-Date -Format G) Create Report completed"
             #endregion
-            
+
 
         }
         Else {
@@ -108,7 +108,7 @@ Process {
     }
 
 End {
-     # none   
+     # none
     }
 
 }

Modules/InstantClone/InstantClone.psm1

@@ -0,0 +1,98 @@
+Function New-InstantClone {
+<#
+    .NOTES
+    ===========================================================================
+     Created by:    William Lam
+     Date:          Apr 29, 2018
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+    ===========================================================================
+    .SYNOPSIS
+        This function demonstrates the use of the new "Parentless" Instant Clone
+        API that was introduced in vSphere 6.7
+    .DESCRIPTION
+        Function to create new "Parentless" Instant Clones in vSphere 6.7
+    .EXAMPLE
+        $SourceVM = "Foo"
+        $newVMName = Foo-IC-1
+        $guestCustomizationValues = @{
+            "guestinfo.ic.hostname" = $newVMName
+            "guestinfo.ic.ipaddress" = "192.168.30.10"
+            "guestinfo.ic.netmask" = "255.255.255.0"
+            "guestinfo.ic.gateway" = "192.168.30.1"
+            "guestinfo.ic.dns" = "192.168.30.1"
+        }
+        New-InstantClone -SourceVM $SourceVM -DestinationVM $newVMName -CustomizationFields $guestCustomizationValues
+    .NOTES
+        Make sure that you have both a vSphere 6.7 env (VC/ESXi) as well as
+        as the latest PowerCLI 10.1 installed which is reuqired to use vSphere 6.7 APIs
+#>
+    param(
+        [Parameter(Mandatory=$true)][String]$SourceVM,
+        [Parameter(Mandatory=$true)][String]$DestinationVM,
+        [Parameter(Mandatory=$true)][Hashtable]$CustomizationFields
+    )
+    $vm = Get-VM -Name $SourceVM
+
+    $config = @()
+    $CustomizationFields.GetEnumerator() | Foreach-Object {
+        $optionValue = New-Object VMware.Vim.OptionValue
+        $optionValue.Key = $_.Key
+        $optionValue.Value = $_.Value
+        $config += $optionValue
+    }
+
+    # SourceVM must either be running or running but in Frozen State
+    if($vm.PowerState -ne "poweredOn") {
+        Write-Host -ForegroundColor Red "Instant Cloning is only supported on a PoweredOn or Frozen VM"
+        break
+    }
+
+    # SourceVM == Powered On
+    if((Get-VM $SourceVM).ExtensionData.Runtime.InstantCloneFrozen -eq $false) {
+
+        # Retrieve all Network Adapters for SourceVM
+        $vmNetworkAdapters = @()
+        $devices = $vm.ExtensionData.Config.Hardware.Device
+        foreach ($device in $devices) {
+            if($device -is [VMware.Vim.VirtualEthernetCard]) {
+                $vmNetworkAdapters += $device
+            }
+        }
+
+        $spec = New-Object VMware.Vim.VirtualMachineInstantCloneSpec
+        $locationSpec = New-Object VMware.Vim.VirtualMachineRelocateSpec
+
+        # Disconect all NICs for new Instant Clone to ensure no dupe addresses on network
+        # post-Instant Clone workflow needs to renable after uypdating GuestOS
+        foreach ($vmNetworkAdapter in $vmNetworkAdapters) {
+            $networkName = $vmNetworkAdapter.backing.deviceName
+            $deviceConfigSpec = New-Object VMware.Vim.VirtualDeviceConfigSpec
+            $deviceConfigSpec.Operation = "edit"
+            $deviceConfigSpec.Device = $vmNetworkAdapter
+            $deviceConfigSpec.Device.backing = New-Object VMware.Vim.VirtualEthernetCardNetworkBackingInfo
+            $deviceConfigSpec.device.backing.deviceName = $networkName
+            $connectable = New-Object VMware.Vim.VirtualDeviceConnectInfo
+            $connectable.MigrateConnect = "disconnect"
+            $deviceConfigSpec.Device.Connectable = $connectable
+            $locationSpec.DeviceChange += $deviceConfigSpec
+        }
+
+        $spec.Config = $config
+        $spec.Location = $locationSpec
+        $spec.Name = $DestinationVM
+    # SourceVM == Frozen
+    } else {
+        $spec = New-Object VMware.Vim.VirtualMachineInstantCloneSpec
+        $locationSpec = New-Object VMware.Vim.VirtualMachineRelocateSpec
+        $spec.Config = $config
+        $spec.Location = $locationSpec
+        $spec.Name = $DestinationVM
+    }
+
+    Write-Host "Creating Instant Clone $DestinationVM ..."
+    $task = $vm.ExtensionData.InstantClone_Task($spec)
+    $task1 = Get-Task -Id ("Task-$($task.value)")
+    $task1 | Wait-Task | Out-Null
+}

Modules/Konfig-ESXi/Konfig-ESXi.psm1

@@ -1,16 +1,16 @@
 function Konfig-ESXi {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
+    Changelog:
     2016.12 ver 1.0 Base Release
-    2016.12 ver 1.1 ESXi 6.5 Tests, Minor enhancements  
+    2016.12 ver 1.1 ESXi 6.5 Tests, Minor enhancements
     ===========================================================================
-    External Code Sources: 
+    External Code Sources:
     Function My-Logger : http://www.virtuallyghetto.com/
     ===========================================================================
     Tested Against Environment:
@@ -18,7 +18,7 @@ function Konfig-ESXi {
     PowerCLI Version: PowerCLI 6.3 R1, PowerCLI 6.5 R1
     PowerShell Version: 4.0, 5.0
     OS Version: Windows 8.1, Server 2012 R2
-    Keyword: ESXi, NTP, SSH, Syslog, SATP, 
+    Keyword: ESXi, NTP, SSH, Syslog, SATP,
     ===========================================================================
 
     .DESCRIPTION
@@ -29,7 +29,7 @@ function Konfig-ESXi {
     * Syslog
     * Power Management
     * HP 3PAR SATP/PSP Rule
-    * ... 
+    * ...
 
     .Example
     Konfig-ESXi -VMHost myesxi.lan.local -NTP 192.168.2.1, 192.168.2.2 -syslog "udp://loginsight.lan.local:514"
@@ -51,14 +51,14 @@ function Konfig-ESXi {
 #>
 
 [CmdletBinding()]
-param( 
+param(
     [Parameter(Mandatory=$True, ValueFromPipeline=$False, Position=0)]
         [String] $VMHost,
     [Parameter(Mandatory=$true, ValueFromPipeline=$False, Position=1)]
         [array]$NTP,
     [Parameter(Mandatory=$true, ValueFromPipeline=$False, Position=2)]
         [String] $syslog
-        
+
 )
 
 Begin {
@@ -75,11 +75,11 @@ Begin {
     }
     function Set-MyESXiOption {
     [CmdletBinding()]
-    param( 
+    param(
         [Parameter(Mandatory=$True, ValueFromPipeline=$False, Position=0)]
             [String] $Name,
         [Parameter(Mandatory=$False, ValueFromPipeline=$False, Position=1)]
-            [String] $Value     
+            [String] $Value
     )
     process {
         $myESXiOption = Get-AdvancedSetting -Entity $ESXiHost -Name $Name
@@ -89,7 +89,7 @@ Begin {
         }
         else {
             My-Logger "    ESXi Option $Name already has Value $Value"
-        } 
+        }
     }
     }
 }
@@ -100,7 +100,7 @@ Process {
     #region: Start vCenter Connection
     My-Logger "Starting to Process ESXi Server Connection to $VMHost ..."
     if (($global:DefaultVIServers).count -gt 0) {
-       Disconnect-VIServer  -Force -Confirm:$False -ErrorAction SilentlyContinue 
+       Disconnect-VIServer  -Force -Confirm:$False -ErrorAction SilentlyContinue
     }
     $VIConnection = Connect-VIServer -Server $VMHost
     if (-not $VIConnection.IsConnected) {
@@ -118,9 +118,9 @@ Process {
     #endregion
 
     if ($Validate -eq $True) {
-        
+
         #region: Enable SSH and disable SSH Warning
-        $SSHService = $ESXiHost | Get-VMHostService | where {$_.Key -eq 'TSM-SSH'} 
+        $SSHService = $ESXiHost | Get-VMHostService | where {$_.Key -eq 'TSM-SSH'}
         My-Logger "Starting SSH Service..."
         if($SSHService.Running -ne $True){
             Start-VMHostService -HostService $SSHService -Confirm:$false | Out-Null
@@ -140,12 +140,12 @@ Process {
         #endregion
 
         #region: Config NTP
-        My-Logger "Removing existing NTP Server..." 
+        My-Logger "Removing existing NTP Server..."
         try {
-            $ESXiHost | Remove-VMHostNtpServer -NtpServer (Get-VMHostNtpServer) -Confirm:$false 
+            $ESXiHost | Remove-VMHostNtpServer -NtpServer (Get-VMHostNtpServer) -Confirm:$false
         }
         catch [System.Exception] {
-            Write-Warning "Error during removing existing NTP Servers."    
+            Write-Warning "Error during removing existing NTP Servers."
         }
         My-Logger "Setting new NTP Servers..."
         foreach ($myNTP in $NTP) {
@@ -154,16 +154,16 @@ Process {
 
         My-Logger "Configure NTP Service..."
         $NTPService = $ESXiHost | Get-VMHostService| Where-Object {$_.key -eq "ntpd"}
-        if($NTPService.Running -eq $True){ 
+        if($NTPService.Running -eq $True){
             Stop-VMHostService -HostService $NTPService -Confirm:$false | Out-Null
         }
-        if($NTPService.Policy -ne "on"){ 
+        if($NTPService.Policy -ne "on"){
             Set-VMHostService -HostService $NTPService -Policy "on" -confirm:$False | Out-Null
         }
 
         My-Logger "Configure Local Time..."
-        $HostTimeSystem = Get-View $ESXiHost.ExtensionData.ConfigManager.DateTimeSystem 
-        $HostTimeSystem.UpdateDateTime([DateTime]::UtcNow) 
+        $HostTimeSystem = Get-View $ESXiHost.ExtensionData.ConfigManager.DateTimeSystem
+        $HostTimeSystem.UpdateDateTime([DateTime]::UtcNow)
 
         My-Logger "Start NTP Service..."
         Start-VMHostService -HostService $NTPService -confirm:$False | Out-Null
@@ -181,16 +181,16 @@ Process {
         #endregion
 
         #region: Configure Static HighPower
-        My-Logger "Setting PowerProfile to Static HighPower..." 
+        My-Logger "Setting PowerProfile to Static HighPower..."
         try {
             $HostView = ($ESXiHost | Get-View)
             (Get-View $HostView.ConfigManager.PowerSystem).ConfigurePowerPolicy(1)
         }
         catch [System.Exception] {
-            Write-Warning "Error during Configure Static HighPower. See latest errors..."    
+            Write-Warning "Error during Configure Static HighPower. See latest errors..."
         }
         #endregion
-        
+
         #region: Conf Syslog
         My-Logger "Setting Syslog Firewall Rule ..."
         $SyslogFW = ($ESXiHost | Get-VMHostFirewallException | where {$_.Name -eq 'syslog'})
@@ -225,7 +225,7 @@ Process {
             $esxcli2.storage.nmp.satp.rule.add.Invoke($arguments)
         }
         catch {
-             Write-Warning "Error during Configure HP 3PAR SATP/PSP Rule. See latest errors..."  
+             Write-Warning "Error during Configure HP 3PAR SATP/PSP Rule. See latest errors..."
         }
 		#endregion
 

Modules/NSXT/NSXT.psd1

@@ -1,3 +1,7 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
 @{
 	ModuleToProcess = 'NSXT.psm1'
 	ModuleVersion = '1.0.0.0'
@@ -7,7 +11,35 @@
 	Copyright = '(c) 2017. All rights reserved.'
 	Description = 'Powershell Module for NSX-T REST API Functions'
 	PowerShellVersion = '5.0'
-    FunctionsToExport = 'Get-NSXTComputeManager','Get-NSXTFabricNode','Get-NSXTFirewallRule','Get-NSXTIPPool','Get-NSXTLogicalSwitch','Get-NSXTManager','Get-NSXTTransportZone','Get-NSXTController'
+    FunctionsToExport = 'Get-NSXTBGPNeighbors',
+                        'Get-NSXTComputeManager',
+                        'Get-NSXTController',
+                        'Get-NSXTEdgeCluster',
+                        'Get-NSXTFabricNode',
+                        'Get-NSXTFabricVM',
+                        'Get-NSXTFirewallRule',
+                        'Get-NSXTForwardingTable',
+                        'Get-NSXTIPPool',
+                        'Get-NSXTLogicalRouter',
+                        'Get-NSXTLogicalRouterPorts',
+                        'Get-NSXTLogicalSwitch',
+                        'Get-NSXTManager',
+                        'Get-NSXTNetworkRoutes',
+                        'Get-NSXTRoutingTable',
+                        'Get-NSXTTraceFlow',
+                        'Get-NSXTTraceFlowObservations',
+                        'Get-NSXTTransportNode',
+                        'Get-NSXTTransportZone',
+                        'Get-NSXTClusterNode',
+                        'Set-NSXTIPPool',
+                        'Set-NSXTLogicalRouter',
+                        'Set-NSXTLogicalSwitch',
+                        'Set-NSXTTraceFlow',
+                        'Get-NSXTIPAMIPBlock',
+                        'Set-NSXTIPAMIPBlock',
+                        'Remove-NSXTIPAMIPBlock'
+
+
 	PrivateData = @{
 		PSData = @{
 			Tags = @('NSX-T','REST')

Modules/PSvLIMessage/PSvLIMessage.psm1

@@ -30,18 +30,18 @@ add-type @"
 
   .SYNOPSIS
 	Push Messages to VMware vRealize Log Insight.
-  
+
   .DESCRIPTION
 	Creates a Messages in VMware vRealize Log Insight via the Ingestion API
 
   .EXAMPLE
 	Push-vLIMessage -vLIServer "loginsight.lan.local" -vLIAgentID "12862842-5A6D-679C-0E38-0E2BE888BB28" -Text "My Test"
-	
+
   .EXAMPLE
 	Push-vLIMessage -vLIServer "loginsight.lan.local" -vLIAgentID "12862842-5A6D-679C-0E38-0E2BE888BB28" -Text "My Test" -Hostname MyTEST -FieldName myTest -FieldContent myTest
-	
+
   .PARAMETER vLIServer
-	Specify the FQDN of your vRealize Log Insight Appliance	
+	Specify the FQDN of your vRealize Log Insight Appliance
 
   .PARAMETER vLIAgentID
 	Specify the vRealize Log Insight Agent ID, e.g. "12862842-5A6D-679C-0E38-0E2BE888BB28"
@@ -54,13 +54,13 @@ add-type @"
 
   .PARAMETER FieldName
 	Specify the a Optional Field Name for vRealize Log Insight
-	
+
   .PARAMETER FieldContent
 	Specify the a Optional FieldContent for the Field in -FieldName for vRealize Log Insight
 	If FielName is missing and FieldContent is given, it will be ignored
-	
+
  #Requires PS -Version 3.0
- 
+
  #>
 function Push-vLIMessage {
 
@@ -88,9 +88,9 @@ function Push-vLIMessage {
 						name = "hostname"
 						content = $Hostname
 						}
-					
+
 		$Fields = @($Field_vLI, $Field_HostName)
-		
+
 		if ($FieldName) {
 			$Field_Custom = [ordered]@{
 					name = $FieldName
@@ -98,14 +98,14 @@ function Push-vLIMessage {
 					}
 			$Fields += @($Field_Custom)
 			}
-			
+
 		$Restcall = @{
 					messages =    ([Object[]]([ordered]@{
 							text = ($Text)
 							fields = ([Object[]]$Fields)
 							}))
 					} | convertto-json -Depth 4
-	
+
 		$Resturl = ("http://" + $vLIServer + ":9000/api/v1/messages/ingest/" + $vLIAgentID)
 		try
 		{

Modules/PerVMEVC/PerVMEVC.psm1

@@ -0,0 +1,196 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+function Get-VMEvcMode {
+<#
+.SYNOPSIS
+    Gathers information on the EVC status of a VM
+.DESCRIPTION
+    Will provide the EVC status for the specified VM
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy, thatcouldbeaproblem.com
+.PARAMETER Name
+    VM name which the function should be ran against
+.EXAMPLE
+	Get-VMEvcMode -Name vmName
+	Retreives the EVC status of the provided VM
+#>
+[CmdletBinding()]
+	param(
+	[Parameter(Mandatory=$true,Position=0,ValueFromPipelineByPropertyName=$true)]
+        $Name
+  	)
+
+    Process {
+        $evVM = @()
+
+        if ($name -is [string]) {$evVM += Get-VM -Name $Name -ErrorAction SilentlyContinue}
+        elseif ($name -is [array]) {
+
+            if ($name[0] -is [string]) {
+                $name | foreach {
+                    $evVM += Get-VM -Name $_ -ErrorAction SilentlyContinue
+                }
+            }
+            elseif ($name[0] -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM = $name}
+
+        }
+        elseif ($name -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM += $name}
+
+        if ($evVM -eq $null) {Write-Warning "No VMs found."}
+        else {
+            $output = @()
+            foreach ($v in $evVM) {
+
+                $report = "" | select Name,EVCMode
+                $report.Name = $v.Name
+                $report.EVCMode = $v.ExtensionData.Runtime.MinRequiredEVCModeKey
+                $output += $report
+
+            }
+
+        return $output
+
+        }
+
+    }
+
+}
+
+function Remove-VMEvcMode {
+<#
+.SYNOPSIS
+    Removes the EVC status of a VM
+.DESCRIPTION
+    Will remove the EVC status for the specified VM
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy, thatcouldbeaproblem.com
+.PARAMETER Name
+    VM name which the function should be ran against
+.EXAMPLE
+	Remove-VMEvcMode -Name vmName
+	Removes the EVC status of the provided VM
+#>
+[CmdletBinding()]
+	param(
+	[Parameter(Mandatory=$true,Position=0,ValueFromPipelineByPropertyName=$true)]
+        $Name
+  	)
+
+    Process {
+        $evVM = @()
+        $updateVM = @()
+
+        if ($name -is [string]) {$evVM += Get-VM -Name $Name -ErrorAction SilentlyContinue}
+        elseif ($name -is [array]) {
+
+            if ($name[0] -is [string]) {
+                $name | foreach {
+                    $evVM += Get-VM -Name $_ -ErrorAction SilentlyContinue
+                }
+            }
+            elseif ($name[0] -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM = $name}
+
+        }
+        elseif ($name -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM += $name}
+
+        if ($evVM -eq $null) {Write-Warning "No VMs found."}
+        else {
+            foreach ($v in $evVM) {
+
+                if (($v.HardwareVersion -ge 'vmx-14' -and $v.PowerState -eq 'PoweredOff') -or ($v.Version -ge 'v14' -and $v.PowerState -eq 'PoweredOff')) {
+
+                    $v.ExtensionData.ApplyEvcModeVM_Task($null, $true) | Out-Null
+                    $updateVM += $v.Name
+
+                }
+                else {Write-Warning $v.Name + " does not have the minimum requirements of being Hardware Version 14 and powered off."}
+
+            }
+
+            if ($updateVM) {
+
+            Start-Sleep -Seconds 2
+            Get-VMEvcMode -Name $updateVM
+
+            }
+
+        }
+
+    }
+
+}
+
+function Set-VMEvcMode {
+<#
+.SYNOPSIS
+    Configures the EVC status of a VM
+.DESCRIPTION
+    Will configure the EVC status for the specified VM
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy, thatcouldbeaproblem.com
+.PARAMETER Name
+    VM name which the function should be ran against
+.PARAMETER EvcMode
+    The EVC Mode key which should be set
+.EXAMPLE
+	Set-VMEvcMode -Name vmName -EvcMode intel-sandybridge
+	Configures the EVC status of the provided VM to be 'intel-sandybridge'
+#>
+[CmdletBinding()]
+	param(
+	[Parameter(Mandatory=$true,Position=0,ValueFromPipelineByPropertyName=$true)]
+        $Name,
+    [Parameter(Mandatory=$true,Position=1)]
+    [ValidateSet("intel-merom","intel-penryn","intel-nehalem","intel-westmere","intel-sandybridge","intel-ivybridge","intel-haswell","intel-broadwell","intel-skylake","amd-rev-e","amd-rev-f","amd-greyhound-no3dnow","amd-greyhound","amd-bulldozer","amd-piledriver","amd-steamroller","amd-zen")]
+        $EvcMode
+  	)
+
+    Process {
+        $evVM = @()
+        $updateVM = @()
+
+        if ($name -is [string]) {$evVM += Get-VM -Name $Name -ErrorAction SilentlyContinue}
+        elseif ($name -is [array]) {
+
+            if ($name[0] -is [string]) {
+                $name | foreach {
+                    $evVM += Get-VM -Name $_ -ErrorAction SilentlyContinue
+                }
+            }
+            elseif ($name[0] -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM = $name}
+
+        }
+        elseif ($name -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl]) {$evVM += $name}
+
+        if ($evVM -eq $null) {Write-Warning "No VMs found."}
+        else {
+
+            $si = Get-View ServiceInstance
+            $evcMask = $si.Capability.SupportedEvcMode | where-object {$_.key -eq $EvcMode} | select -ExpandProperty FeatureMask
+
+            foreach ($v in $evVM) {
+
+                if (($v.HardwareVersion -ge 'vmx-14' -and $v.PowerState -eq 'PoweredOff') -or ($v.Version -ge 'v14' -and $v.PowerState -eq 'PoweredOff')) {
+
+                    $v.ExtensionData.ApplyEvcModeVM_Task($evcMask, $true) | Out-Null
+                    $updateVM += $v.Name
+
+                }
+                else {Write-Warning $v.Name + " does not have the minimum requirements of being Hardware Version 14 and powered off."}
+
+            }
+
+            if ($updateVM) {
+
+            Start-Sleep -Seconds 2
+            Get-VMEvcMode -Name $updateVM
+
+            }
+
+        }
+
+    }
+
+}

Modules/ProactiveHA/ProactiveHA.psm1

@@ -1,4 +1,8 @@
-Function New-PHAProvider {
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function New-PHAProvider {
 <#
     .NOTES
     ===========================================================================

Modules/Recommend-Sizing/Recommend-Sizing.psm1

@@ -1,17 +1,21 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
 function Recommend-Sizing {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
-    2016.11 ver 1.0 Base Release 
+    Changelog:
+    2016.11 ver 1.0 Base Release
     2016.11 ver 1.1 Optional Stats Collection
     2016.11 ver 1.2 VM Stats from Realtime Data and new Counters
     ===========================================================================
-    External Code Sources:  
+    External Code Sources:
     http://www.lucd.info/2011/04/22/get-the-maximum-iops/
     https://communities.vmware.com/thread/485386
     ===========================================================================
@@ -25,16 +29,16 @@ function Recommend-Sizing {
     ===========================================================================
 
     .DESCRIPTION
-    This Function collects Basic vSphere Informations for a Hardware Sizing Recommandation. Focus is in Compute Ressources.        
+    This Function collects Basic vSphere Informations for a Hardware Sizing Recommandation. Focus is in Compute Ressources.
 
     .Example
-    Recommend-Sizing -ClusterNames Cluster01, Cluster02 -Stats -StatsRange 60 -Verbose    
+    Recommend-Sizing -ClusterNames Cluster01, Cluster02 -Stats -StatsRange 60 -Verbose
 
     .Example
-    Recommend-Sizing -ClusterNames Cluster01, Cluster02 
+    Recommend-Sizing -ClusterNames Cluster01, Cluster02
 
     .Example
-    Recommend-Sizing -ClusterNames Cluster01 
+    Recommend-Sizing -ClusterNames Cluster01
 
     .PARAMETER ClusterNames
     List of your vSphere Cluser Names to process.
@@ -53,14 +57,14 @@ function Recommend-Sizing {
 #>
 
 [CmdletBinding()]
-param( 
+param(
     [Parameter(Mandatory=$True, ValueFromPipeline=$False, Position=0)]
         [Array] $ClusterNames,
     [Parameter(Mandatory=$False, ValueFromPipeline=$False, Position=1, ParameterSetName = "Stats")]
         [switch] $Stats,
      [Parameter(Mandatory=$False, ValueFromPipeline=$False, Position=2, ParameterSetName = "Stats")]
-        [int] $StatsRange = 1440      
-        
+        [int] $StatsRange = 1440
+
 )
 Begin {
      if ($Stats) {
@@ -70,7 +74,7 @@ Begin {
 
     $Validate = $True
     #region: Check Clusters
-    Write-Verbose "$(Get-Date -Format G) Starting Cluster Validation..." 
+    Write-Verbose "$(Get-Date -Format G) Starting Cluster Validation..."
     foreach ($ClusterName in $ClusterNames) {
         $TestCluster = Get-Cluster -Name $ClusterName -ErrorAction SilentlyContinue -Verbose:$False
         if(!($TestCluster)){
@@ -82,7 +86,7 @@ Begin {
             $Validate = $False
         }
     }
-    Write-Verbose "$(Get-Date -Format G) Cluster Validation completed" 
+    Write-Verbose "$(Get-Date -Format G) Cluster Validation completed"
     #endregion
 }
 
@@ -91,7 +95,7 @@ Process {
     if ($Validate -eq $True) {
         foreach ($ClusterName in $ClusterNames) {
             #region: Get Cluster Objects
-            Write-Verbose "$(Get-Date -Format G) Collect $ClusterName Cluster Objects..." 
+            Write-Verbose "$(Get-Date -Format G) Collect $ClusterName Cluster Objects..."
             $Cluster =  Get-Cluster -Name $ClusterName -Verbose:$False
             $ClusterVMs = $Cluster | Get-VM -Verbose:$False
             $ClusterVMsPoweredOn = $ClusterVMs | where {$_.PowerState -eq "PoweredOn"}
@@ -101,24 +105,24 @@ Process {
             $HostsAverageMemoryUsage = $([math]::round( (($ClusterHosts | Measure-Object -Average -Property MemoryUsageGB).Average / ($ClusterHosts | Measure-Object -Average -Property MemoryTotalGB).Average) * 100,1 ))
             $HostsAverageCpuUsageMhz = [math]::round( ($ClusterHosts | Measure-Object -Average -Property CpuUsageMhz).Average,1 )
             $HostsAverageCpuUsage = $([math]::round( (($ClusterHosts | Measure-Object -Average -Property CpuUsageMhz).Average / ($ClusterHosts | Measure-Object -Average -Property CpuTotalMhz).Average) * 100,1 ))
-            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Cluster Objects completed" 
+            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Cluster Objects completed"
             #endregion
 
             #region: CPU Calculation
-            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) CPU Details..." 
+            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) CPU Details..."
             $VMvCPUs = ($ClusterVMs | Measure-Object -Sum -Property NumCpu).sum
             $LogicalThreads = $Cluster.ExtensionData.Summary.NumCpuThreads
             $CpuCores = $Cluster.ExtensionData.Summary.NumCpuCores
             $vCPUpCPUratio = [math]::round( $VMvCPUs / $LogicalThreads,1 )
-            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) CPU Details completed." 
+            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) CPU Details completed."
             #endregion
 
             #region: Memory Calculation
-            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Memory Details..." 
+            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Memory Details..."
             $AllocatedVMMemoryGB = [math]::round( ($ClusterVMs | Measure-Object -Sum -Property MemoryGB).sum )
             $PhysicalMemory = [math]::round( $Cluster.ExtensionData.Summary.TotalMemory / 1073741824,1 )
             $MemoryUsage = [math]::round( ($AllocatedVMMemoryGB / $PhysicalMemory) * 100 ,1 )
-            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Memory Details completed" 
+            Write-Verbose "$(Get-Date -Format G) Collect $($Cluster.name) Memory Details completed"
             #endregion
 
             if ($Stats) {
@@ -129,10 +133,10 @@ Process {
                 $VMStats = Get-Stat -Realtime -Stat $VMMetrics -Entity $ClusterVMsPoweredOn -Start $Start -Verbose:$False
                 Write-Verbose "$(Get-Date -Format G) Create $($Cluster.name) VM Stats completed"
                 #endregion
-                
+
                 #region: Creating VM Stats Report
                 Write-Verbose "$(Get-Date -Format G) Process $($Cluster.name) VM Stats Report..."
-                $ReportVMPerf = @() 
+                $ReportVMPerf = @()
                 $ReportVMPerf = $VMStats | Group-Object -Property {$_.Entity.Name},Instance | %{
                                     New-Object PSObject -Property @{
                                     IOPSWriteAvg = ($_.Group | `
@@ -168,7 +172,7 @@ Process {
                                 CapacityGB = $CapacityGB
                             }
                             $reportDiskSpace += $Report
-                        }   
+                        }
                     }
                 }
             Write-Verbose "$(Get-Date -Format G) Process $($Cluster.name) VM Disk Space Report completed"
@@ -188,9 +192,9 @@ Process {
                 DrsEnabled = $Cluster.DrsEnabled
                 Hosts = $Cluster.ExtensionData.Summary.NumHosts
                 HostsAverageMemoryUsageGB = $HostsAverageMemoryUsageGB
-                HostsAverageMemoryUsage = "$HostsAverageMemoryUsage %" 
+                HostsAverageMemoryUsage = "$HostsAverageMemoryUsage %"
                 HostsAverageCpuUsageMhz = $HostsAverageCpuUsageMhz
-                HostsAverageCpuUsage = "$HostsAverageCpuUsage %" 
+                HostsAverageCpuUsage = "$HostsAverageCpuUsage %"
                 PhysicalCPUCores = $CpuCores
                 LogicalCPUThreads = $LogicalThreads
                 VMs =  $ClusterVMs.count
@@ -198,7 +202,7 @@ Process {
                 VMvCPUs = $VMvCPUs
 				vCPUpCPUratio = "$vCPUpCPUratio : 1"
                 PhysicalMemoryGB = $PhysicalMemory
-                AllocatedVMMemoryGB = $AllocatedVMMemoryGB        
+                AllocatedVMMemoryGB = $AllocatedVMMemoryGB
 				ClusterMemoryUsage = "$MemoryUsage %"
                 SumVMDiskSpaceGB = [math]::round( ($reportDiskSpace | Measure-Object -Sum -Property CapacityGB).sum, 1 )
                 SumDatastoreSpaceGB = [math]::round( ($DatastoreReport | Measure-Object -Sum -Property CapacityGB).sum, 1 )
@@ -217,7 +221,7 @@ Process {
         Else {
             Write-Error "Validation Failed! Processing Skipped"
         }
-        
+
     }
 
     End {

Modules/SRM/.gitattributes

@@ -0,0 +1 @@
+*.psd1 diff

Modules/SRM/.gitignore

@@ -0,0 +1 @@
+*.zip

Modules/SRM/Examples/ReportConfiguration.ps1

@@ -0,0 +1,176 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+# Depends on SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+# It is assumed that the connection to VC and SRM Server have already been made
+
+Function Get-SrmConfigReportSite {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    Get-SrmServer $SrmServer |
+        Format-Table -Wrap -AutoSize @{Label="SRM Site Name"; Expression={$_.ExtensionData.GetSiteName()} },
+            @{Label="SRM Host"; Expression={$_.Name} },
+            @{Label="SRM Port"; Expression={$_.Port} },
+            @{Label="Version"; Expression={$_.Version} },
+            @{Label="Build"; Expression={$_.Build} },
+            @{Label="SRM Peer Site Name"; Expression={$_.ExtensionData.GetPairedSite().Name} }
+}
+
+Function Get-SrmConfigReportPlan {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    Get-SrmRecoveryPlan -SrmServer $SrmServer | %{
+        $rp = $_
+        $rpinfo = $rp.GetInfo()
+        $peerState = $rp.GetPeer().State
+        $pgs = Get-SrmProtectionGroup -RecoveryPlan $rp
+        $pgnames = $pgs | %{ $_.GetInfo().Name }
+
+        $output = "" | select plan, state, peerState, groups
+        $output.plan = $rpinfo.Name
+        $output.state = $rpinfo.State
+        $output.peerState = $peerState
+        if ($pgnames) {
+            $output.groups = [string]::Join(",`r`n", $pgnames)
+        } else {
+            $output.groups = "NONE"
+        }
+
+        $output
+    } | Format-Table -Wrap -AutoSize @{Label="Recovery Plan Name"; Expression={$_.plan} },
+                                   @{Label="Recovery State"; Expression={$_.state} },
+                                   @{Label="Peer Recovery State"; Expression={$_.peerState} },
+                                   @{Label="Protection Groups"; Expression={$_.groups}}
+}
+
+
+Function Get-SrmConfigReportProtectionGroup {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    Get-SrmProtectionGroup -SrmServer $SrmServer | %{
+        $pg = $_
+        $pginfo = $pg.GetInfo()
+        $pgstate = $pg.GetProtectionState()
+        $peerState = $pg.GetPeer().State
+        $rps = Get-SrmRecoveryPlan -ProtectionGroup $pg
+        $rpnames = $rps | %{ $_.GetInfo().Name }
+
+        $output = "" | select name, type, state, peerState, plans
+        $output.name = $pginfo.Name
+        $output.type = $pginfo.Type
+        $output.state = $pgstate
+        $output.peerState = $peerState
+        if ($rpnames) {
+            $output.plans = [string]::Join(",`r`n", $rpnames)
+        } else {
+            $output.plans = "NONE"
+        }
+
+        $output
+    } | Format-Table -Wrap -AutoSize @{Label="Protection Group Name"; Expression={$_.name} },
+                                   @{Label="Type"; Expression={$_.type} },
+                                   @{Label="Protection State"; Expression={$_.state} },
+                                   @{Label="Peer Protection State"; Expression={$_.peerState} },
+                                   @{Label="Recovery Plans"; Expression={$_.plans} }
+}
+
+
+Function Get-SrmConfigReportProtectedDatastore {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    Get-SrmProtectionGroup -SrmServer $SrmServer -Type "san" | %{
+        $pg = $_
+        $pginfo = $pg.GetInfo()
+        $pds = Get-SrmProtectedDatastore -ProtectionGroup $pg
+        $pds | %{
+            $pd = $_
+            $output = "" | select datacenter, group, name, capacity, free
+            $output.datacenter = $pd.Datacenter.Name
+            $output.group = $pginfo.Name
+            $output.name = $pd.Name
+            $output.capacity = $pd.CapacityGB
+            $output.free = $pd.FreeSpaceGB
+
+            $output
+
+        }
+    } | Format-Table -Wrap -AutoSize -GroupBy "datacenter" @{Label="Datastore Name"; Expression={$_.name} },
+                                   @{Label="Capacity GB"; Expression={$_.capacity} },
+                                   @{Label="Free GB"; Expression={$_.free} },
+                                   @{Label="Protection Group"; Expression={$_.group} }
+}
+
+
+Function Get-SrmConfigReportProtectedVm {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $srmversion = Get-SrmServerVersion -SrmServer $SrmServer
+    $srmMajorVersion, $srmMinorVersion = $srmversion -split "\."
+
+    Get-SrmProtectionGroup -SrmServer $SrmServer | %{
+        $pg = $_
+        $pginfo = $pg.GetInfo()
+        $pvms = Get-SrmProtectedVM -ProtectionGroup $pg
+        $rps = Get-SrmRecoveryPlan -ProtectionGroup $pg
+        $rpnames = $rps | %{ $_.GetInfo().Name }
+        $pvms | %{
+            $pvm = $_
+            if ($srmMajorVersion -ge 6 -or ($srmMajorVersion -eq 5 -and $srmMinorVersion -eq 8)) {
+                $rs = $rps | Select -First 1 | %{ $_.GetRecoverySettings($pvm.Vm.MoRef) }
+            }
+            $output = "" | select group, name, moRef, needsConfiguration, state, plans, priority, finalPowerState, preCallouts, postCallouts
+            $output.group = $pginfo.Name
+            $output.name = $pvm.Vm.Name
+            $output.moRef = $pvm.Vm.MoRef # this is necessary in case we can't retrieve the name when VC is unavailable
+            $output.needsConfiguration = $pvm.NeedsConfiguration
+            $output.state = $pvm.State
+            $output.plans = [string]::Join(",`r`n", $rpnames)
+            if ($rs) {
+                $output.priority = $rs.RecoveryPriority
+                $output.finalPowerState = $rs.FinalPowerState
+                $output.preCallouts = $rs.PrePowerOnCallouts.Count
+                $output.postCallouts = $rs.PostPowerOnCallouts.Count
+            }
+            $output
+
+        }
+    } | Format-Table -Wrap -AutoSize @{Label="VM Name"; Expression={$_.name} },
+                                   @{Label="VM MoRef"; Expression={$_.moRef} },
+                                   @{Label="Needs Config"; Expression={$_.needsConfiguration} },
+                                   @{Label="VM Protection State"; Expression={$_.state} },
+                                   @{Label="Protection Group"; Expression={$_.group} },
+                                   @{Label="Recovery Plans"; Expression={$_.plans} },
+                                   @{Label="Recovery Priority"; Expression={$_.priority} },
+                                   @{Label="Final Power State"; Expression={$_.finalPowerState} },
+                                   @{Label="Pre-PowerOn Callouts"; Expression={$_.preCallouts} },
+                                   @{Label="Post-PowerOn Callouts"; Expression={$_.postCallouts} }
+
+}
+
+Function Get-SrmConfigReport {
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    Get-SrmConfigReportSite -SrmServer $SrmServer
+    Get-SrmConfigReportPlan -SrmServer $SrmServer
+    Get-SrmConfigReportProtectionGroup -SrmServer $SrmServer
+    Get-SrmConfigReportProtectedDatastore -SrmServer $SrmServer
+    Get-SrmConfigReportProtectedVm -SrmServer $SrmServer
+}

Modules/SRM/Examples/SrmTagging.ps1

@@ -0,0 +1,43 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+# Depends on SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+# It is assumed that the connections to active VC and SRM Server have already been made
+
+Import-Module Meadowcroft.SRM -Prefix Srm
+
+$TagCategoryName = 'Meadowcroft.SRM.VM'
+$TagCategoryDescription = 'Tag category for tagging VMs with SRM state'
+
+# If the tag category doesn't exist, create it and the relevant tags
+$TagCategory = Get-TagCategory -Name $TagCategoryName -ErrorAction SilentlyContinue
+if (-Not $TagCategory) {
+    Write-Output "Creating Tag Category $TagCategoryName"
+    $TagCategory = New-TagCategory -Name $TagCategoryName -Description $TagCategoryDescription -EntityType 'VirtualMachine'
+
+    Write-Output "Creating Tag SrmProtectedVm"
+    New-Tag -Name 'SrmProtectedVm' -Category $TagCategory -Description "VM protected by VMware SRM"
+    Write-Output "Creating Tag SrmTestVm"
+    New-Tag -Name 'SrmTestVm' -Category $TagCategory -Description "Test VM instantiated by VMware SRM"
+    Write-Output "Creating Tag SrmPlaceholderVm"
+    New-Tag -Name 'SrmPlaceholderVm' -Category $TagCategory -Description "Placeholder VM used by VMware SRM"
+}
+
+$protectedVmTag = Get-Tag -Name 'SrmProtectedVm' -Category $TagCategory
+$testVmTag = Get-Tag -Name 'SrmTestVm' -Category $TagCategory
+$placeholderVmTag = Get-Tag -Name 'SrmPlaceholderVm' -Category $TagCategory
+
+# Assign protected tag to a VM, use ready state to get "local" protected VMs
+Get-SrmProtectedVM -State Ready | %{ New-TagAssignment -Tag $protectedVmTag -Entity $(Get-VIObjectByVIView $_.Vm) | Out-Null }
+
+# Assign test tag to a VM
+Get-SrmTestVM | %{ New-TagAssignment -Tag $testVmTag -Entity $_ | Out-Null }
+
+# Assign placeholder tag to a VM
+Get-SrmPlaceholderVM | %{ New-TagAssignment -Tag $placeholderVmTag -Entity $_ | Out-Null }

Modules/SRM/LICENSE.txt

@@ -0,0 +1,74 @@
+				   Apache License
+                    Version 2.0, January 2004
+                http://www.apache.org/licenses/
+
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+(b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!)  The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.
+
+   Copyright 2017-2021 VMware, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied.
+
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+

Modules/SRM/Meadowcroft.Srm.Protection.ps1

@@ -0,0 +1,431 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+# SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+
+<#
+.SYNOPSIS
+Get the subset of protection groups matching the input criteria
+
+.PARAMETER Name
+Return protection groups matching the specified name
+
+.PARAMETER Type
+Return protection groups matching the specified protection group
+type. For SRM 5.0-5.5 this is either 'san' for protection groups
+consisting of a set of replicated datastores or 'vr' for vSphere
+Replication based protection groups.
+
+.PARAMETER RecoveryPlan
+Return protection groups associated with a particular recovery
+plan
+
+.PARAMETER SrmServer
+the SRM server to use for this operation.
+#>
+Function Get-ProtectionGroup {
+    [cmdletbinding()]
+    Param(
+        [Parameter(position=1)][string] $Name,
+        [string] $Type,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan[]] $RecoveryPlan,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+    begin {
+        $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+        $pgs = @()
+    }
+    process {
+        if ($RecoveryPlan) {
+            foreach ($rp in $RecoveryPlan) {
+                $pgs += $RecoveryPlan.GetInfo().ProtectionGroups
+            }
+            $pgs = Select_UniqueByMoRef($pgs)
+        } else {
+            $pgs += $api.Protection.ListProtectionGroups()
+        }
+    }
+    end {
+        $pgs | ForEach-Object {
+            $pg = $_
+            $pgi = $pg.GetInfo()
+            $selected = (-not $Name -or ($Name -eq $pgi.Name)) -and (-not $Type -or ($Type -eq $pgi.Type))
+            if ($selected) {
+                Add-Member -InputObject $pg -MemberType NoteProperty -Name "Name" -Value $pgi.Name
+                $pg
+            }
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+Get the subset of protected VMs matching the input criteria
+
+.PARAMETER Name
+Return protected VMs matching the specified name
+
+.PARAMETER State
+Return protected VMs matching the specified state. For protected
+VMs on the protected site this is usually 'ready', for
+placeholder VMs this is 'shadowing'
+
+.PARAMETER ProtectionGroup
+Return protected VMs associated with particular protection
+groups
+#>
+Function Get-ProtectedVM {
+    [cmdletbinding()]
+    Param(
+        [Parameter(position=1)][string] $Name,
+        [VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectionState] $State,
+        [VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectionState] $PeerState,
+        [switch] $ConfiguredOnly,
+        [switch] $UnconfiguredOnly,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup[]] $ProtectionGroup,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan[]] $RecoveryPlan,
+        [string] $ProtectionGroupName,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    if ($null -eq $ProtectionGroup) {
+        $ProtectionGroup = Get-ProtectionGroup -Name $ProtectionGroupName -RecoveryPlan $RecoveryPlan -SrmServer $SrmServer
+    }
+    $ProtectionGroup | ForEach-Object {
+        $pg = $_
+        $pg.ListProtectedVms() | ForEach-Object {
+            # try and update the view data for the protected VM
+            try {
+                $_.Vm.UpdateViewData()
+            } catch {
+                Write-Error $_
+            } finally {
+                $_
+            }
+        } | Where-object { -not $Name -or ($Name -eq $_.Vm.Name) } |
+            where-object { -not $State -or ($State -eq $_.State) } |
+            where-object { -not $PeerState -or ($PeerState -eq $_.PeerState) } |
+            where-object { ($ConfiguredOnly -and $_.NeedsConfiguration -eq $false) -or ($UnconfiguredOnly -and $_.NeedsConfiguration -eq $true) -or (-not $ConfiguredOnly -and -not $UnconfiguredOnly) }
+    }
+}
+
+
+<#
+.SYNOPSIS
+Get the unprotected VMs that are associated with a protection group
+
+.PARAMETER ProtectionGroup
+Return unprotected VMs associated with particular protection
+groups. For VR protection groups this is VMs that are associated
+with the PG but not configured, For ABR protection groups this is
+VMs on replicated datastores associated with the group that are not
+configured.
+#>
+Function Get-UnProtectedVM {
+    [cmdletbinding()]
+    Param(
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup[]] $ProtectionGroup,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan[]] $RecoveryPlan,
+        [string] $ProtectionGroupName,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    if ($null -eq $ProtectionGroup) {
+        $ProtectionGroup = Get-ProtectionGroup -Name $ProtectionGroupName -RecoveryPlan $RecoveryPlan -SrmServer $SrmServer
+    }
+
+    $associatedVMs = @()
+    $protectedVmRefs = @()
+
+    $ProtectionGroup | ForEach-Object {
+        $pg = $_
+        # For VR listAssociatedVms to get list of VMs
+        if ($pg.GetInfo().Type -eq 'vr') {
+            $associatedVMs += @($pg.ListAssociatedVms() | Get-VIObjectByVIView)
+        }
+        # TODO test this: For ABR get VMs on GetProtectedDatastore
+        if ($pg.GetInfo().Type -eq 'san') {
+            $pds = @(Get-ProtectedDatastore -ProtectionGroup $pg)
+            $pds | ForEach-Object {
+                $ds = Get-Datastore -id $_.MoRef
+                $associatedVMs += @(Get-VM -Datastore $ds)
+            }
+        }
+
+        # get protected VMs
+        $protectedVmRefs += @(Get-ProtectedVM -ProtectionGroup $pg | ForEach-Object { $_.Vm.MoRef } | Select-Object -Unique)
+    }
+
+    # get associated but unprotected VMs
+    $associatedVMs | Where-Object { $protectedVmRefs -notcontains $_.ExtensionData.MoRef }
+}
+
+
+#Untested as I don't have ABR setup in my lab yet
+<#
+.SYNOPSIS
+Get the subset of protected Datastores matching the input criteria
+
+.PARAMETER ProtectionGroup
+Return protected datastores associated with particular protection
+groups
+#>
+Function Get-ProtectedDatastore {
+    [cmdletbinding()]
+    Param(
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup[]] $ProtectionGroup,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan[]] $RecoveryPlan,
+        [string] $ProtectionGroupName,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    if (-not $ProtectionGroup) {
+        $ProtectionGroup = Get-ProtectionGroup -Name $ProtectionGroupName -RecoveryPlan $RecoveryPlan -SrmServer $SrmServer
+    }
+    $ProtectionGroup | ForEach-Object {
+        $pg = $_
+        if ($pg.GetInfo().Type -eq 'san') { # only supported for array based replication datastores
+            $pg.ListProtectedDatastores()
+        }
+    }
+}
+
+
+#Untested as I don't have ABR setup in my lab yet
+<#
+.SYNOPSIS
+Get the replicated datastores that aren't associated with a protection group.
+#>
+Function Get-ReplicatedDatastore {
+    [cmdletbinding()]
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    $api.Protection.ListUnassignedReplicatedDatastores()
+}
+
+<#
+.SYNOPSIS
+Protect a VM using SRM
+
+.PARAMETER ProtectionGroup
+The protection group that this VM will belong to
+
+.PARAMETER Vm
+The virtual machine to protect
+#>
+Function Protect-VM {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup] $ProtectionGroup,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $Vm,
+        [Parameter (ValueFromPipeline=$true)][VMware.Vim.VirtualMachine] $VmView
+    )
+
+    $moRef = Get_MoRefFromVmObj -Vm $Vm -VmView $VmView
+
+    $pgi = $ProtectionGroup.GetInfo()
+    #TODO query protection status first
+
+    if ($moRef) {
+        if ($pgi.Type -eq 'vr') {
+            $ProtectionGroup.AssociateVms(@($moRef))
+        }
+        $protectionSpec = New-Object VMware.VimAutomation.Srm.Views.SrmProtectionGroupVmProtectionSpec
+        $protectionSpec.Vm = $moRef
+        $protectTask = $ProtectionGroup.ProtectVms($protectionSpec)
+        while(-not $protectTask.IsComplete()) { Start-Sleep -Seconds 1 }
+        $protectTask.GetResult()
+    } else {
+        throw "Can't protect the VM, no MoRef found."
+    }
+}
+
+
+<#
+.SYNOPSIS
+Unprotect a VM using SRM
+
+.PARAMETER ProtectionGroup
+The protection group that this VM will be removed from
+
+.PARAMETER Vm
+The virtual machine to unprotect
+#>
+Function Unprotect-VM {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup] $ProtectionGroup,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $Vm,
+        [Parameter (ValueFromPipeline=$true)][VMware.Vim.VirtualMachine] $VmView,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectedVm] $ProtectedVm
+    )
+
+    $moRef = Get_MoRefFromVmObj -Vm $Vm -VmView $VmView -ProtectedVm $ProtectedVm
+
+    $pgi = $ProtectionGroup.GetInfo()
+    $protectTask = $ProtectionGroup.UnprotectVms($moRef)
+    while(-not $protectTask.IsComplete()) { Start-Sleep -Seconds 1 }
+    if ($pgi.Type -eq 'vr') {
+        $ProtectionGroup.UnassociateVms(@($moRef))
+    }
+    $protectTask.GetResult()
+}
+
+<#
+.SYNOPSIS
+Get a protection group folder
+
+.PARAMETER SrmServer
+The SRM Server to query for the protection group folder
+#>
+Function Get-ProtectionGroupFolder {
+    [cmdletbinding()]
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    $folder = $api.Protection.GetProtectionGroupRootFolder()
+
+    return $folder
+}
+
+<#
+.SYNOPSIS
+Create a new protection group
+
+.PARAMETER Name
+The name of the protection group
+
+.PARAMETER Description
+Description of the protection group
+
+.PARAMETER Folder
+The protection group folder in which to create the new protection group
+
+.PARAMETER ArrayReplication
+Set if protection group is for replicating VMs using Array based replication
+
+.PARAMETER vSphereReplication
+Set if protection group is for replicating VMs with vSphere Replication
+
+.PARAMETER VMs
+For vSphere Replication based protection, the VMs to add to the replication
+group. These should already be replicated.
+
+.PARAMETER VMViews
+For vSphere Replication based protection, the VMs to add to the replication
+group. These should already be replicated.
+
+.PARAMETER SrmServer
+The SRM Server to perform the operation against
+#>
+Function New-ProtectionGroup {
+    [cmdletbinding(DefaultParameterSetName="VR", SupportsShouldProcess=$True, ConfirmImpact="Medium")]
+    [OutputType([VMware.VimAutomation.Srm.Views.SrmProtectionGroup])]
+    Param(
+        [Parameter (Mandatory=$true)] $Name,
+        $Description,
+        [VMware.VimAutomation.Srm.Views.SrmProtectionGroupFolder] $Folder,
+        [Parameter (ParameterSetName="ABR", Mandatory=$true)][switch] $ArrayReplication,
+        [Parameter (ValueFromPipeline=$true, ParameterSetName="ABR")][VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.Datastore[]] $Datastores,
+        [Parameter (ValueFromPipeline=$true, ParameterSetName="ABR")][VMware.Vim.Datastore[]] $DatastoreViews,
+        [Parameter (ParameterSetName="VR", Mandatory=$true)][switch] $vSphereReplication,
+        [Parameter (ValueFromPipeline=$true, ParameterSetName="VR")][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine[]] $VMs,
+        [Parameter (ValueFromPipeline=$true, ParameterSetName="VR")][VMware.Vim.VirtualMachine[]] $VMViews,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint $SrmServer
+    [VMware.VimAutomation.Srm.Views.SrmCreateProtectionGroupTask] $task = $null
+
+    #get root folder if this wasn't specified as a parameter
+    if(-not $Folder) {
+        $Folder = Get-ProtectionGroupFolder -SrmServer $SrmServer
+    }
+
+    if ($vSphereReplication) {
+        #create list of managed object references from VM and/or VM view arrays
+        [VMware.Vim.ManagedObjectReference[]]$moRefs = @()
+        foreach ($vm in $VMs) {
+            $moRefs += Get_MoRefFromVmObj -Vm $Vm
+        }
+        foreach ($VmView in $VMViews) {
+            $moRefs += Get_MoRefFromVmObj -VmView $VmView
+        }
+
+        if ($pscmdlet.ShouldProcess($Name, "New")) {
+            $task = $api.Protection.CreateHbrProtectionGroup($Folder.MoRef, $Name, $Description, $moRefs)
+        }
+
+    } elseif ($ArrayReplication) {
+        #create list of managed object references from VM and/or VM view arrays
+        $moRefs = @()
+        foreach ($ds in $Datastores) {
+            $moRefs += $ds.ExtensionData.MoRef
+        }
+        foreach ($DsView in $DatastoreViews) {
+            $moRefs += $DsView.MoRef
+        }
+
+        if ($pscmdlet.ShouldProcess($Name, "New")) {
+            $task = $api.Protection.CreateAbrProtectionGroup($Folder.MoRef, $Name, $Description, $moRefs)
+        }
+
+    } else {
+        throw "Undetermined protection group type"
+    }
+
+    # Complete task
+    while(-not $task.IsCreateProtectionGroupComplete()) { Start-Sleep -Seconds 1 }
+
+    # Retrieve the protection group, and protect associated VMs
+    $pg = $task.GetNewProtectionGroup()
+    if ($pg) {
+        $unProtectedVMs = Get-UnProtectedVM -ProtectionGroup $pg
+        $unProtectedVMs | Protect-VM -ProtectionGroup $pg
+    }
+
+    return $pg
+}
+
+
+<#
+.SYNOPSIS
+Delete a protection group
+
+.PARAMETER ProtectionGroup
+The protection group to remove
+
+.PARAMETER SrmServer
+The SRM Server to perform the operation against
+#>
+Function Remove-ProtectionGroup {
+    [cmdletbinding(SupportsShouldProcess=$True, ConfirmImpact="High")]
+    [OutputType([VMware.VimAutomation.Srm.Views.RemoveProtectionGroupTask])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup] $ProtectionGroup,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint $SrmServer
+    [VMware.VimAutomation.Srm.Views.RemoveProtectionGroupTask] $task = $null
+
+    $pginfo = $ProtectionGroup.GetInfo()
+    if ($pscmdlet.ShouldProcess($pginfo.Name, "Remove")) {
+        $task = $api.Protection.RemoveProtectionGroup($ProtectionGroup.MoRef)
+    }
+
+    return $task
+}

Modules/SRM/Meadowcroft.Srm.Recovery.ps1

@@ -0,0 +1,565 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+# SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+
+<#
+.SYNOPSIS
+Get the subset of recovery plans matching the input criteria
+
+.PARAMETER Name
+Return recovery plans matching the specified name
+
+.PARAMETER ProtectionGroup
+Return recovery plans associated with particular protection
+groups
+#>
+Function Get-RecoveryPlan {
+    [cmdletbinding()]
+    Param(
+        [Parameter(position=1)][string] $Name,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup[]] $ProtectionGroup,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    begin {
+        $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+        $rps = @()
+    }
+    process {
+        if ($ProtectionGroup) {
+            foreach ($pg in $ProtectionGroup) {
+                $rps += $pg.ListRecoveryPlans()
+            }
+            $rps = Select_UniqueByMoRef($rps)
+        } else {
+            $rps += $api.Recovery.ListPlans()
+        }
+    }
+    end {
+        $rps | ForEach-Object {
+            $rp = $_
+            $rpi = $rp.GetInfo()
+            $selected = (-not $Name -or ($Name -eq $rpi.Name))
+            if ($selected) {
+                Add-Member -InputObject $rp -MemberType NoteProperty -Name "Name" -Value $rpi.Name
+                $rp
+            }
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+Start a Recovery Plan action like test, recovery, cleanup, etc.
+
+.PARAMETER RecoveryPlan
+The recovery plan to start
+
+.PARAMETER RecoveryMode
+The recovery mode to invoke on the plan. May be one of "Test", "Cleanup", "Failover", "Migrate", "Reprotect"
+#>
+Function Start-RecoveryPlan {
+    [cmdletbinding(SupportsShouldProcess=$True, ConfirmImpact="High")]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true, Position=1)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [VMware.VimAutomation.Srm.Views.SrmRecoveryPlanRecoveryMode] $RecoveryMode = [VMware.VimAutomation.Srm.Views.SrmRecoveryPlanRecoveryMode]::Test,
+        [bool] $SyncData = $True
+    )
+
+    # Validate with informative error messages
+    $rpinfo = $RecoveryPlan.GetInfo()
+
+    # Create recovery options
+    $rpOpt = New-Object VMware.VimAutomation.Srm.Views.SrmRecoveryOptions
+    $rpOpt.SyncData = $SyncData
+
+    # Prompt the user to confirm they want to execute the action
+    if ($pscmdlet.ShouldProcess($rpinfo.Name, $RecoveryMode)) {
+        if ($rpinfo.State -eq 'Protecting') {
+            throw "This recovery plan action needs to be initiated from the other SRM instance"
+        }
+
+        $RecoveryPlan.Start($RecoveryMode, $rpOpt)
+    }
+}
+
+<#
+.SYNOPSIS
+Stop a running Recovery Plan action.
+
+.PARAMETER RecoveryPlan
+The recovery plan to stop
+#>
+Function Stop-RecoveryPlan {
+    [cmdletbinding(SupportsShouldProcess=$True,ConfirmImpact="High")]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true, Position=1)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan
+    )
+
+    # Validate with informative error messages
+    $rpinfo = $RecoveryPlan.GetInfo()
+
+    # Prompt the user to confirm they want to cancel the running action
+    if ($pscmdlet.ShouldProcess($rpinfo.Name, 'Cancel')) {
+
+        $RecoveryPlan.Cancel()
+    }
+}
+
+<#
+.SYNOPSIS
+Retrieve the historical results of a recovery plan
+
+.PARAMETER RecoveryPlan
+The recovery plan to retrieve the history for
+#>
+Function Get-RecoveryPlanResult {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true, Position=1)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [VMware.VimAutomation.Srm.Views.SrmRecoveryPlanRecoveryMode] $RecoveryMode,
+        [VMware.VimAutomation.Srm.Views.SrmRecoveryResultResultState] $ResultState,
+        [DateTime] $StartedAfter,
+        [DateTime] $startedBefore,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    # Get the history objects
+    $history = $api.Recovery.GetHistory($RecoveryPlan.MoRef)
+    $resultCount = $history.GetResultCount()
+
+    if ($resultCount -gt 0) {
+        $results = $history.GetRecoveryResult($resultCount)
+
+        $results |
+            Where-Object { -not $RecoveryMode -or $_.RunMode -eq $RecoveryMode } |
+            Where-Object { -not $ResultState -or $_.ResultState -eq $ResultState } |
+            Where-Object { $null -eq $StartedAfter -or $_.StartTime -gt $StartedAfter } |
+            Where-Object { $null -eq $StartedBefore -or $_.StartTime -lt $StartedBefore }
+    }
+}
+
+<#
+.SYNOPSIS
+Exports a recovery plan result object to XML format
+
+.PARAMETER RecoveryPlanResult
+The recovery plan result to export
+#>
+Function Export-RecoveryPlanResultAsXml {
+    [cmdletbinding()]
+    [OutputType([xml])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true, Position=1)][VMware.VimAutomation.Srm.Views.SrmRecoveryResult] $RecoveryPlanResult,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    $RecoveryPlan = $RecoveryPlanResult.Plan
+    $history = $api.Recovery.GetHistory($RecoveryPlan.MoRef)
+    $lines = $history.GetResultLength($RecoveryPlanResult.Key)
+    [xml] $history.RetrieveStatus($RecoveryPlanResult.Key, 0, $lines)
+}
+
+<#
+.SYNOPSIS
+Add a protection group to a recovery plan. This requires SRM 5.8 or later.
+
+.PARAMETER RecoveryPlan
+The recovery plan the protection group will be associated with
+
+.PARAMETER ProtectionGroup
+The protection group to associate with the recovery plan
+#>
+Function Add-ProtectionGroupToRecoveryPlan {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true, Position=1)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true, Position=2)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup] $ProtectionGroup
+    )
+
+    if ($RecoveryPlan -and $ProtectionGroup) {
+        foreach ($pg in $ProtectionGroup) {
+            try {
+                $RecoveryPlan.AddProtectionGroup($pg.MoRef)
+            } catch {
+                Write-Error $_
+            }
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+Remove a protection group to a recovery plan. This requires SRM 6.5 or later.
+
+.PARAMETER RecoveryPlan
+The recovery plan the protection group will be disassociated from
+
+.PARAMETER ProtectionGroup
+The protection group to disassociate from the recovery plan
+#>
+Function Remove-ProtectionGroupFromRecoveryPlan {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroup] $ProtectionGroup
+    )
+
+    if ($RecoveryPlan -and $ProtectionGroup) {
+        foreach ($pg in $ProtectionGroup) {
+            try {
+                $RecoveryPlan.RemoveProtectionGroupFromRecoveryPlan($pg.MoRef)
+            } catch {
+                Write-Error $_
+            }
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+Get the recovery settings of a protected VM. This requires SRM 5.8 or later.
+
+.PARAMETER RecoveryPlan
+The recovery plan the settings will be retrieved from.
+
+.PARAMETER Vm
+The virtual machine to retieve recovery settings for.
+
+#>
+Function Get-RecoverySetting {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $Vm,
+        [Parameter (ValueFromPipeline=$true)][VMware.Vim.VirtualMachine] $VmView,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectedVm] $ProtectedVm
+    )
+
+    $moRef = Get_MoRefFromVmObj -Vm $Vm -VmView $VmView -ProtectedVm $ProtectedVm
+
+    if ($RecoveryPlan -and $moRef) {
+        $RecoveryPlan.GetRecoverySettings($moRef)
+    }
+}
+
+<#
+.SYNOPSIS
+Get the recovery settings of a protected VM. This requires SRM 5.8 or later.
+
+.PARAMETER RecoveryPlan
+The recovery plan the settings will be retrieved from.
+
+.PARAMETER Vm
+The virtual machine to configure recovery settings on.
+
+.PARAMETER RecoverySettings
+The recovery settings to configure. These should have been retrieved via a
+call to Get-RecoverySettings
+
+#>
+Function Set-RecoverySetting {
+    [cmdletbinding(SupportsShouldProcess=$true, ConfirmImpact="Medium")]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $Vm,
+        [Parameter (ValueFromPipeline=$true)][VMware.Vim.VirtualMachine] $VmView,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectedVm] $ProtectedVm,
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings
+    )
+
+
+    $moRef = Get_MoRefFromVmObj -Vm $Vm -VmView $VmView -ProtectedVm $ProtectedVm
+
+    if ($RecoveryPlan -and $moRef -and $RecoverySettings) {
+        if ($PSCmdlet.ShouldProcess("$moRef", "Set")) {
+            $RecoveryPlan.SetRecoverySettings($moRef, $RecoverySettings)
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+Create a new per-Vm command to add to the SRM Recovery Plan
+
+.PARAMETER Command
+The command script to execute.
+
+.PARAMETER Description
+The user friendly description of this script.
+
+.PARAMETER Timeout
+The number of seconds this command has to execute before it will be timedout.
+
+.PARAMETER RunInRecoveredVm
+For a post-power on command this flag determines whether it will run on the
+recovered VM or on the SRM server.
+
+#>
+Function New-Command {
+    [cmdletbinding(SupportsShouldProcess=$true, ConfirmImpact="None")]
+    Param(
+        [Parameter (Mandatory=$true)][string] $Command,
+        [Parameter (Mandatory=$true)][string] $Description,
+        [int]    $Timeout = 300,
+        [switch] $RunInRecoveredVm = $false
+    )
+
+    if($PSCmdlet.ShouldProcess("Description", "New")) {
+        $srmWsdlCmd = New-Object VMware.VimAutomation.Srm.WsdlTypes.SrmCommand
+        $srmCmd = New-Object VMware.VimAutomation.Srm.Views.SrmCommand -ArgumentList $srmWsdlCmd
+        $srmCmd.Command = $Command
+        $srmCmd.Description = $Description
+        $srmCmd.RunInRecoveredVm = $RunInRecoveredVm
+        $srmCmd.Timeout = $Timeout
+        $srmCmd.Uuid = [guid]::NewGuid()
+
+        return $srmCmd
+    }
+}
+
+<# Internal function #>
+Function Add_Command {
+    [cmdletbinding()]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmCommand] $SrmCommand,
+        [Parameter (Mandatory=$true)][bool] $PostRecovery
+    )
+
+    if ($PostRecovery) {
+        $commands = $RecoverySettings.PostPowerOnCallouts
+    } else {
+        $commands = $RecoverySettings.PrePowerOnCallouts
+    }
+
+    if (-not $commands) {
+        $commands = New-Object System.Collections.Generic.List[VMware.VimAutomation.Srm.Views.SrmCallout]
+    }
+    $commands.Add($SrmCommand)
+
+    if ($PostRecovery) {
+        $RecoverySettings.PostPowerOnCallouts = $commands
+    } else {
+        $RecoverySettings.PrePowerOnCallouts = $commands
+    }
+}
+
+<#
+.SYNOPSIS
+Add an SRM command to the set of pre recovery callouts for a VM.
+
+.PARAMETER RecoverySettings
+The recovery settings to update. These should have been retrieved via a
+call to Get-RecoverySettings
+
+.PARAMETER SrmCommand
+The command to add to the list.
+
+#>
+Function Add-PreRecoveryCommand {
+    [cmdletbinding()]
+    [OutputType([VMware.VimAutomation.Srm.Views.SrmRecoverySettings])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmCommand] $SrmCommand
+    )
+    Add_Command -RecoverySettings $RecoverySettings -SrmCommand $SrmCommand -PostRecovery $false
+    return $RecoverySettings
+}
+
+<#
+.SYNOPSIS
+Remove an SRM command from the set of pre recovery callouts for a VM.
+
+.PARAMETER RecoverySettings
+The recovery settings to update. These should have been retrieved via a
+call to Get-RecoverySettings
+
+.PARAMETER SrmCommand
+The command to remove from the list.
+
+#>
+Function Remove-PreRecoveryCommand {
+    [cmdletbinding(SupportsShouldProcess=$true, ConfirmImpact="Low")]
+    [OutputType([VMware.VimAutomation.Srm.Views.SrmRecoverySettings])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmCommand] $SrmCommand
+    )
+
+    if ($pscmdlet.ShouldProcess($SrmCommand.Description, "Remove")) {
+        $RecoverySettings.PrePowerOnCallouts.Remove($SrmCommand)
+    }
+
+    return $RecoverySettings
+}
+
+<#
+.SYNOPSIS
+Add an SRM command to the set of post recovery callouts for a VM.
+
+.PARAMETER RecoverySettings
+The recovery settings to update. These should have been retrieved via a
+call to Get-RecoverySettings
+
+.PARAMETER SrmCommand
+The command to add to the list.
+
+#>
+Function Add-PostRecoveryCommand {
+    [cmdletbinding()]
+    [OutputType([VMware.VimAutomation.Srm.Views.SrmRecoverySettings])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmCommand] $SrmCommand
+    )
+
+    Add_Command -RecoverySettings $RecoverySettings -SrmCommand $SrmCommand -PostRecovery $true
+
+    return $RecoverySettings
+}
+
+
+<#
+.SYNOPSIS
+Remove an SRM command from the set of post recovery callouts for a VM.
+
+.PARAMETER RecoverySettings
+The recovery settings to update. These should have been retrieved via a
+call to Get-RecoverySettings
+
+.PARAMETER SrmCommand
+The command to remove from the list.
+
+#>
+Function Remove-PostRecoveryCommand {
+    [cmdletbinding(SupportsShouldProcess=$true, ConfirmImpact="Low")]
+    [OutputType([VMware.VimAutomation.Srm.Views.SrmRecoverySettings])]
+    Param(
+        [Parameter (Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmRecoverySettings] $RecoverySettings,
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmCommand] $SrmCommand
+    )
+
+    if ($pscmdlet.ShouldProcess($SrmCommand.Description, "Remove")) {
+        $RecoverySettings.PostPowerOnCallouts.Remove($SrmCommand)
+    }
+
+    return $RecoverySettings
+}
+
+
+<#
+.SYNOPSIS
+Create a new recovery plan
+
+.PARAMETER Name
+The name for this recovery plan
+
+.PARAMETER Description
+A description of the recovery plan
+
+.PARAMETER Folder
+The recovery plan folder in which to create this recovery plan. Will default to
+the root recovery plan folder
+
+.PARAMETER ProtectionGroups
+The protection groups to associate with this recovery plan
+
+.PARAMETER TestNetworkMappings
+The test network mappings to configure as part of this recovery plan
+
+.PARAMETER SrmServer
+The SRM Server to operate against
+#>
+Function New-RecoveryPlan {
+    [cmdletbinding(SupportsShouldProcess=$true, ConfirmImpact="Medium")]
+    Param(
+        [Parameter (Mandatory=$true)][string] $Name,
+        [string] $Description,
+        [VMware.VimAutomation.Srm.Views.SrmRecoveryPlanFolder] $Folder,
+        [VMware.VimAutomation.Srm.Views.SrmProtectionGroup[]] $ProtectionGroups,
+        [VMware.VimAutomation.Srm.Views.SrmRecoveryTestNetworkMapping[]] $TestNetworkMappings,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    if (-not $Folder) {
+        $Folder = Get-RecoveryPlanFolder -SrmServer $SrmServer
+    }
+
+    $protectionGroupmRefs += @( $ProtectionGroups | ForEach-Object { $_.MoRef } | Select-Object -Unique)
+
+    [VMware.VimAutomation.Srm.Views.CreateRecoveryPlanTask] $task = $null
+
+    if ($PSCmdlet.ShouldProcess($Name, "New")) {
+        $task = $api.Recovery.CreateRecoveryPlan(
+            $Name,
+            $Folder.MoRef,
+            $protectionGroupmRefs,
+            $Description,
+            $TestNetworkMappings
+        )
+    }
+
+    while(-not $task.IsCreateRecoveryPlanComplete()) { Start-Sleep -Seconds 1 }
+
+    $task.GetNewRecoveryPlan()
+}
+
+<#
+.SYNOPSIS
+Remove a recovery plan permanently
+
+.PARAMETER RecoveryPlan
+The recovery plan to remove
+
+.PARAMETER SrmServer
+The SRM Server to operate against
+#>
+Function Remove-RecoveryPlan {
+    [cmdletbinding(SupportsShouldProcess=$True, ConfirmImpact="High")]
+    Param(
+        [Parameter (Mandatory=$true)][VMware.VimAutomation.Srm.Views.SrmRecoveryPlan] $RecoveryPlan,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    $rpinfo = $RecoveryPlan.GetInfo()
+    if ($pscmdlet.ShouldProcess($rpinfo.Name, "Remove")) {
+        $api.Recovery.DeleteRecoveryPlan($RecoveryPlan.MoRef)
+    }
+}
+
+<#
+.SYNOPSIS
+Get a recovery plan folder
+
+.PARAMETER SrmServer
+The SRM Server to query for the recovery plan folder
+#>
+Function Get-RecoveryPlanFolder {
+    [cmdletbinding()]
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+
+    $folder = $api.Recovery.GetRecoveryPlanRootFolder()
+
+    return $folder
+}

Modules/SRM/Meadowcroft.Srm.Storage.ps1

@@ -0,0 +1,33 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+# SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+
+<#
+.SYNOPSIS
+Trigger Discover Devices for Site Recovery Manager
+
+.OUTPUTS
+Returns discover devices task
+#>
+Function Start-DiscoverDevice {
+    [cmdletbinding(SupportsShouldProcess=$True, ConfirmImpact="Medium")]
+    [OutputType([VMware.VimAutomation.Srm.Views.DiscoverDevicesTask])]
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $api = Get-ServerApiEndpoint -SrmServer $SrmServer
+    $name = $SrmServer.Name
+    [VMware.VimAutomation.Srm.Views.DiscoverDevicesTask] $task = $null
+    if ($pscmdlet.ShouldProcess($name, "Rescan Storage Devices")) {
+        $task = $api.Storage.DiscoverDevices()
+    }
+    return $task
+}

Modules/SRM/Meadowcroft.Srm.psd1

@@ -0,0 +1,101 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+#
+# Module manifest for module 'Meadowcroft.Srm'
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'Meadowcroft.Srm.psm1'
+
+# Version number of this module.
+ModuleVersion = '0.2'
+
+# ID used to uniquely identify this module
+GUID = 'f9247009-9168-4a21-831b-819f82884ffe'
+
+# Author of this module
+Author = 'Ben Meadowcroft'
+
+# Company or vendor of this module
+CompanyName = 'VMware, Inc'
+
+# Copyright statement for this module
+Copyright = '(c) 2014 - 2017. All rights reserved.'
+
+# Description of the functionality provided by this module
+# Description = ''
+
+# Minimum version of the Windows PowerShell engine required by this module
+# PowerShellVersion = ''
+
+# Name of the Windows PowerShell host required by this module
+# PowerShellHostName = ''
+
+# Minimum version of the Windows PowerShell host required by this module
+# PowerShellHostVersion = ''
+
+# Minimum version of Microsoft .NET Framework required by this module
+# DotNetFrameworkVersion = ''
+
+# Minimum version of the common language runtime (CLR) required by this module
+# CLRVersion = ''
+
+# Processor architecture (None, X86, Amd64) required by this module
+# ProcessorArchitecture = ''
+
+# Modules that must be imported into the global environment prior to importing this module
+RequiredModules = @{ModuleName='VMware.VimAutomation.Srm'; ModuleVersion='6.5'}
+
+# Assemblies that must be loaded prior to importing this module
+# RequiredAssemblies = @()
+
+# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+# ScriptsToProcess = @()
+
+# Type files (.ps1xml) to be loaded when importing this module
+# TypesToProcess = @()
+
+# Format files (.ps1xml) to be loaded when importing this module
+# FormatsToProcess = @()
+
+# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+NestedModules = 'Meadowcroft.Srm.Recovery.ps1','Meadowcroft.Srm.Protection.ps1','Meadowcroft.Srm.Storage.ps1'
+# NestedModules = @()
+
+# Functions to export from this module, note that internal functions use '_' not '-' as separator
+FunctionsToExport = '*-*'
+
+# Cmdlets to export from this module
+CmdletsToExport = '*'
+
+# Variables to export from this module
+VariablesToExport = '*'
+
+# Aliases to export from this module
+AliasesToExport = '*'
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess
+# PrivateData = ''
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+DefaultCommandPrefix = 'Srm'
+
+}

Modules/SRM/Meadowcroft.Srm.psm1

@@ -0,0 +1,156 @@
+<#
+Copyright 2017-2021 VMware, Inc.
+SPDX-License-Identifier: Apache-2.0
+#>
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+# SRM Helper Methods - https://github.com/benmeadowcroft/SRM-Cmdlets
+
+<#
+.SYNOPSIS
+This is intended to be an "internal" function only. It filters a
+pipelined input of objects and elimiates duplicates as identified
+by the MoRef property on the object.
+
+.LINK
+https://github.com/benmeadowcroft/SRM-Cmdlets/
+#>
+Function Select_UniqueByMoRef {
+
+    Param(
+        [Parameter (ValueFromPipeline=$true)] $in
+    )
+    process {
+        $moref = New-Object System.Collections.ArrayList
+        $in | Sort-Object | Select-Object MoRef -Unique | ForEach-Object { $moref.Add($_.MoRef) } > $null
+        $in | ForEach-Object {
+            if ($_.MoRef -in $moref) {
+                $moref.Remove($_.MoRef)
+                $_ #output
+            }
+        }
+    }
+}
+
+<#
+.SYNOPSIS
+This is intended to be an "internal" function only. It gets the
+MoRef property of a VM from either a VM object, a VM view, or the
+protected VM object.
+#>
+Function Get_MoRefFromVmObj {
+    Param(
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $Vm,
+        [Parameter (ValueFromPipeline=$true)][VMware.Vim.VirtualMachine] $VmView,
+        [Parameter (ValueFromPipeline=$true)][VMware.VimAutomation.Srm.Views.SrmProtectionGroupProtectedVm] $ProtectedVm
+    )
+
+
+    $moRef = $null
+    if ($Vm.ExtensionData.MoRef) { # VM object
+        $moRef = $Vm.ExtensionData.MoRef
+    } elseif ($VmView.MoRef) { # VM view
+        $moRef = $VmView.MoRef
+    } elseif ($protectedVm) {
+        $moRef = $ProtectedVm.Vm.MoRef
+    }
+
+    $moRef
+}
+
+<#
+.SYNOPSIS
+Lookup the srm instance for a specific server.
+#>
+Function Get-Server {
+    [cmdletbinding()]
+    Param(
+        [string] $SrmServerAddress,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    $found = $null
+
+    if ($SrmServer) {
+        $found = $SrmServer
+    } elseif ($SrmServerAddress) {
+        # search for server address in default servers
+        $global:DefaultSrmServers | ForEach-Object {
+            if ($_.Name -ieq $SrmServerAddress) {
+                $found = $_
+            }
+        }
+        if (-not $found) {
+            throw "SRM server $SrmServerAddress not found. Connect-Server must be called first."
+        }
+    }
+
+    if (-not $found) {
+        #default result
+        $found = $global:DefaultSrmServers[0]
+    }
+
+    return $found;
+}
+
+<#
+.SYNOPSIS
+Retrieve the SRM Server Version
+#>
+Function Get-ServerVersion {
+    [cmdletbinding()]
+    Param(
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+    $srm = Get-Server $SrmServer
+    $srm.Version
+}
+
+<#
+.SYNOPSIS
+Lookup the SRM API endpoint for a specific server.
+#>
+Function Get-ServerApiEndpoint {
+    [cmdletbinding()]
+    Param(
+        [string] $SrmServerAddress,
+        [VMware.VimAutomation.Srm.Types.V1.SrmServer] $SrmServer
+    )
+
+    [VMware.VimAutomation.Srm.Types.V1.SrmServer] $server = Get-Server -SrmServerAddress $SrmServerAddress -SrmServer $SrmServer
+
+    return $server.ExtensionData
+}
+
+<#
+.SYNOPSIS
+Get the placeholder VMs that are associated with SRM
+#>
+Function Get-PlaceholderVM {
+    [cmdletbinding()]
+    Param()
+    Get-VM @Args | Where-Object {$_.ExtensionData.Config.ManagedBy.extensionKey -like "com.vmware.vcDr*" -and $_.ExtensionData.Config.ManagedBy.Type -ieq 'placeholderVm'}
+}
+
+<#
+.SYNOPSIS
+Get the test VMs that are associated with SRM
+#>
+Function Get-TestVM {
+    [cmdletbinding()]
+    Param()
+    Get-VM @Args | Where-Object {$_.ExtensionData.Config.ManagedBy.extensionKey -like "com.vmware.vcDr*" -and $_.ExtensionData.Config.ManagedBy.Type -ieq 'testVm'}
+}
+
+<#
+.SYNOPSIS
+Get the VMs that are replicated using vSphere Replication. These may not be SRM
+protected VMs.
+#>
+Function Get-ReplicatedVM {
+    [cmdletbinding()]
+    Param()
+    Get-VM @Args | Where-Object {($_.ExtensionData.Config.ExtraConfig | Where-Object { $_.Key -eq 'hbr_filter.destination' -and $_.Value } )}
+}

Modules/SRM/NOTICE.txt

@@ -0,0 +1,10 @@
+
+Copyright (c) 2017-2021 VMware, Inc. All Rights Reserved.
+
+This product is licensed to you under the Apache License version 2.0 (the "License").  You may not use this product except in compliance with the License.
+
+This product may include a number of subcomponents with separate copyright notices and license terms. Your use of these subcomponents is subject to the terms and conditions of the subcomponent's license, as noted in the LICENSE file.
+
+Copyright (c) 2021 VMware, Inc. All Rights Reserved.
+
+This product is licensed to you under the BSD-2-Clause License. You may not use this product except in compliance with the License.

Modules/SRM/README.md

@@ -0,0 +1,81 @@
+# SRM PowerCLI Cmdlets
+
+Helper functions for working with VMware SRM 6.5 with PowerCLI 6.5.1 or later. PowerShell 5.0 and above is required.
+
+This module is provided for illustrative/educational purposes to explain how the PowerCLI access to the SRM public API can be used.
+
+## Getting Started
+
+### Getting the SRM cmdlets
+
+The latest version of the software can be cloned from the git repository:
+
+    git clone https://github.com/benmeadowcroft/SRM-Cmdlets.git
+
+Or downloaded as a [zip file](https://github.com/benmeadowcroft/SRM-Cmdlets/archive/master.zip).
+
+Specific releases (compatible with earlier PowerCLI and SRM versions) can be downloaded via the [release page](https://github.com/benmeadowcroft/SRM-Cmdlets/releases).
+
+### Deploy SRM-Cmdlets module
+
+After cloning (or downloading and extracting) the PowerShell module, you can import the module into your current PowerShell session by by passing the path to `Meadowcroft.Srm.psd1` to the `Import-Module` cmdlet, e.g.:
+
+    Import-Module -Name .\SRM-Cmdlets\Meadowcroft.Srm.psd1
+
+You can also install the module into the PowerShell path so it can be loaded implicitly. See [Microsoft's Installing Modules instructions](http://msdn.microsoft.com/en-us/library/dd878350) for more details on how to do this.
+
+The module uses the default prefix of `Srm` for the custom functions it defines. This can be overridden when importing the module by setting the value of the `-Prefix` parameter when calling `Import-Module`.
+
+### Connecting to SRM
+
+After installing the module the next step is to connect to the SRM server. Details of how to do this are located in the [PowerCLI 6.5.1 User's Guide](http://pubs.vmware.com/vsphere-65/topic/com.vmware.powercli.ug.doc/GUID-A5F206CF-264D-4565-8CB9-4ED1C337053F.html)
+
+    $credential = Get-Credential
+    Connect-VIServer -Server vc-a.example.com -Credential $credential
+    Connect-SrmServer -Credential $credential -RemoteCredential $credential
+
+At this point we've just been using the cmdlets provided by PowerCLI, the PowerCLI documentation also provides some examples of how to call the SRM API to perform various tasks. In the rest of this introduction we'll perform some of those tasks using the custom functions defined in this project.
+
+### Report the Protected Virtual Machines and Their Protection Groups
+
+Goal: Create a simple report listing the VMs protected by SRM and the protection group they belong to.
+
+    Get-SrmProtectionGroup | %{
+        $pg = $_
+        Get-SrmProtectedVM -ProtectionGroup $pg } | %{
+            $output = "" | select VmName, PgName
+            $output.VmName = $_.Vm.Name
+            $output.PgName = $pg.GetInfo().Name
+            $output
+        } | Format-Table @{Label="VM Name"; Expression={$_.VmName} },
+                         @{Label="Protection group name"; Expression={$_.PgName}
+    }
+
+### Report the Last Recovery Plan Test
+
+Goal: Create a simple report listing the state of the last test of a recovery plan
+
+    Get-SrmRecoveryPlan | %{ $_ |
+        Get-SrmRecoveryPlanResult -RecoveryMode Test | select -First 1
+    } | Select Name, StartTime, RunMode, ResultState | Format-Table
+
+
+### Execute a Recovery Plan Test
+
+Goal: for a specific recovery plan, execute a test failover. Note the "local" SRM server we are connected to should be the recovery site in order for this to be successful.
+
+    Get-SrmRecoveryPlan -Name "Name of Plan" | Start-SrmRecoveryPlan -RecoveryMode Test
+
+### Export the Detailed XML Report of the Last Recovery Plan Workflow
+
+Goal: get the XML report of the last recovery plan execution for a specific recovery plan.
+
+    Get-SrmRecoveryPlan -Name "Name of Plan" | Get-SrmRecoveryPlanResult |
+        select -First 1 | Export-SrmRecoveryPlanResultAsXml
+
+### Protect a Replicated VM
+
+Goal: Take a VM replicated using vSphere Replication or Array Based Replication, add it to an appropriate protection group and configure it for protection
+
+    $pg = Get-SrmProtectionGroup "Name of Protection Group"
+    Get-VM vm-01a | Protect-SrmVM -ProtectionGroup $pg

Modules/SaltStackConfig/SaltStackConfig.Format.ps1xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<Configuration>
+    <ViewDefinitions>
+        <View>
+            <Name>SscConnection</Name>
+            <ViewSelectedBy>
+                <TypeName>SscConnection</TypeName>
+            </ViewSelectedBy>
+            <TableControl>
+                <TableHeaders>
+                    <TableColumnHeader>
+                        <Width>30</Width>
+                        <Label>Name</Label>
+                    </TableColumnHeader>
+                    <TableColumnHeader>
+                        <Width>30</Width>
+                        <Label>User</Label>
+                    </TableColumnHeader>
+                    <TableColumnHeader>
+                        <Label>Authenticated</Label>
+                    </TableColumnHeader>
+                </TableHeaders>
+                <TableRowEntries>
+                    <TableRowEntry>
+                        <TableColumnItems>
+                            <TableColumnItem>
+                                <PropertyName>Name</PropertyName>
+                            </TableColumnItem>
+                            <TableColumnItem>
+                                <PropertyName>User</PropertyName>
+                            </TableColumnItem>
+                            <TableColumnItem>
+                                <PropertyName>Authenticated</PropertyName>
+                            </TableColumnItem>
+                    </TableColumnItems>
+                    </TableRowEntry>
+                </TableRowEntries>
+            </TableControl>
+        </View>
+    </ViewDefinitions>
+</Configuration>

Modules/SaltStackConfig/SaltStackConfig.psd1

@@ -0,0 +1,129 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+#
+# Module manifest for module 'SaltStackConfig'
+#
+# Generated by: Brian Wuchner
+#
+# Generated on: 11/28/2021
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'SaltStackConfig.psm1'
+
+# Version number of this module.
+ModuleVersion = '0.0.8'
+
+# Supported PSEditions
+# CompatiblePSEditions = @()
+
+# ID used to uniquely identify this module
+GUID = '9a36e984-2f63-450e-8c14-a6bccb18f87a'
+
+# Author of this module
+Author = 'Brian Wuchner'
+
+# Company or vendor of this module
+CompanyName = 'VMware'
+
+# Copyright statement for this module
+Copyright = '(c) VMware. All rights reserved.'
+
+# Description of the functionality provided by this module
+Description = 'Community sourced PowerShell wrapper module for the vRealize Automation SaltStack Config API.'
+
+# Minimum version of the Windows PowerShell engine required by this module
+PowerShellVersion = '4.0'
+
+# Name of the Windows PowerShell host required by this module
+# PowerShellHostName = ''
+
+# Minimum version of the Windows PowerShell host required by this module
+# PowerShellHostVersion = ''
+
+# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# DotNetFrameworkVersion = ''
+
+# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# CLRVersion = ''
+
+# Processor architecture (None, X86, Amd64) required by this module
+# ProcessorArchitecture = ''
+
+# Modules that must be imported into the global environment prior to importing this module
+# RequiredModules = @()
+
+# Assemblies that must be loaded prior to importing this module
+# RequiredAssemblies = @()
+
+# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+# ScriptsToProcess = @()
+
+# Type files (.ps1xml) to be loaded when importing this module
+# TypesToProcess = @()
+
+# Format files (.ps1xml) to be loaded when importing this module
+FormatsToProcess = @('SaltStackConfig.Format.ps1xml')
+
+# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+# NestedModules = @()
+
+# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+FunctionsToExport = @('Connect-SscServer', 'Disconnect-SscServer', 'Get-SscActivity', 'Get-SscData', 'Get-SscJob', 'Get-SscMaster', 'Get-SscMinionCache', 'Get-SscReturn', 
+        'Get-SscSchedule','Get-SscFile','Set-SscFile','New-SscFile','Remove-SscFile','Get-SscLicense','Get-SscvRALicense','Get-SscMinionKey','Set-SscMinionKey',
+        'Remove-SscMinionKey')
+
+# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+CmdletsToExport = @()
+
+# Variables to export from this module
+VariablesToExport = '*'
+
+# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+AliasesToExport = @()
+
+# DSC resources to export from this module
+# DscResourcesToExport = @()
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+PrivateData = @{
+
+    PSData = @{
+
+        # Tags applied to this module. These help with module discovery in online galleries.
+        # Tags = @()
+
+        # A URL to the license for this module.
+        # LicenseUri = ''
+
+        # A URL to the main website for this project.
+        # ProjectUri = ''
+
+        # A URL to an icon representing this module.
+        # IconUri = ''
+
+        # ReleaseNotes of this module
+        # ReleaseNotes = ''
+
+    } # End of PSData hashtable
+
+} # End of PrivateData hashtable
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+# DefaultCommandPrefix = ''
+
+}

Modules/SaltStackConfig/SaltStackConfig.psm1

@@ -0,0 +1,640 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Connect-SscServer {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    Use this function to create the cookie/header to connect to SaltStack Config RaaS API
+  .DESCRIPTION
+    This function will allow you to connect to a vRealize Automation SaltStack Config RaaS API.
+    A global variable will be set with the Servername & Cookie/Header value for use by other functions.
+  .EXAMPLE
+    PS C:\> Connect-SscServer -Server 'salt.example.com' -Username 'root' -Password 'VMware1!'
+    This will default to internal user authentication.
+  .EXAMPLE
+    PS C:\> Connect-SscServer -Server 'salt.example.com' -Username 'bwuchner' -Password 'MyPassword1!' -AuthSource 'LAB Directory'
+    This will use the 'Lab Directory' LDAP authentication source.
+  .EXAMPLE
+    PS C:\> Connect-SscServer -Server 'salt.example.com'
+    This will prompt for credentials
+  .EXAMPLE
+    $creds = Get-Credential
+    PS C:\> Connect-SscServer -Server 'salt.example.com' -Credential $creds -AuthSource 'LAB Directory'
+    This will connect to the 'LAB Directory' LDAP authentication source using a specified credential.
+#>
+  param(
+    [Parameter(Mandatory=$true, Position=0)][string]$server,
+    [Parameter(Mandatory=$true, ParameterSetName='PlainText', Position=1)][string]$username,
+    [Parameter(Mandatory=$true, ParameterSetName='PlainText', Position=2)][ValidateNotNullOrEmpty()][string]$password,
+    [Parameter(Mandatory=$false, Position=3)][string]$AuthSource='internal',
+    [Parameter(Mandatory=$false, ParameterSetName='Credential')][PSCredential]$Credential,
+    [Parameter(Mandatory=$false)][Switch]$SkipCertificateCheck,
+    [Parameter(Mandatory=$false)][System.Net.SecurityProtocolType]$SslProtocol
+  )
+
+  if ($PSCmdlet.ParameterSetName -eq 'Credential' -AND $Credential -eq $null) { $Credential = Get-Credential}
+  if ($Credential) {
+    $username = $Credential.GetNetworkCredential().username
+    $password = $Credential.GetNetworkCredential().password
+  }
+
+  if ($SkipCertificateCheck) {
+    # This if statement is using example code from https://stackoverflow.com/questions/11696944/powershell-v3-invoke-webrequest-https-error
+    add-type @"
+    using System.Net;
+    using System.Security.Cryptography.X509Certificates;
+    public class TrustAllCertsPolicy : ICertificatePolicy {
+        public bool CheckValidationResult(
+            ServicePoint srvPoint, X509Certificate certificate,
+            WebRequest request, int certificateProblem) {
+            return true;
+        }
+    }
+"@
+    [System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy
+  } # end if SkipCertificate Check
+  
+  if ($SslProtocol) {
+    [System.Net.ServicePointManager]::SecurityProtocol = $SslProtocol
+  }
+
+  $loginBody = @{'username'=$username; 'password'=$password; 'config_name'=$AuthSource}
+  try {
+    $webRequest = Invoke-WebRequest -Uri "https://$server/account/login" -SessionVariable ws
+    $ws.headers.Add('X-Xsrftoken', $webRequest.headers.'x-xsrftoken')
+    $webRequest = Invoke-WebRequest -Uri "https://$server/account/login" -WebSession $ws -method POST -body (ConvertTo-Json $loginBody)
+    $webRequestJson = ConvertFrom-JSON $webRequest.Content
+    $global:DefaultSscConnection = New-Object psobject -property @{ 'SscWebSession'=$ws; 'Name'=$server; 'ConnectionDetail'=$webRequestJson; 
+      'User'=$webRequestJson.attributes.config_name +'\'+ $username; 'Authenticated'=$webRequestJson.authenticated; PSTypeName='SscConnection' }
+    
+	  # Return the connection object
+	  $global:DefaultSscConnection
+  } catch {
+    Write-Error ("Failure connecting to $server. " + $_)
+  } # end try/catch block
+}
+
+Function Disconnect-SscServer { 
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This function clears a previously created cookie/header used to connect to SaltStack Config
+  .DESCRIPTION
+    This function will clear the global variable used to connect to the vRealize Automation SaltStack Config RaaS API
+  .EXAMPLE
+    PS C:\> Disconnect-SscServer
+#>
+  if ($global:DefaultSscConnection) {
+    $global:DefaultSscConnection = $null 
+  } else {
+    Write-Error 'Could not find an existing connection.'
+  } # end if
+}
+
+Function Get-SscData {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    Use this function to call the SaltStack Config API.
+    Additional helper functions will call this function, this is where the majority of the logic will happen.
+  .DESCRIPTION
+    This function will pass resource/method/arguments to the vRealize Automation SaltStack Config RaaS API.
+    It depends on a global variable created by Connect-SscServer.
+  .EXAMPLE
+    PS C:\> Get-SscData -Resource 'minions' -Method 'get_minion_cache'
+#>
+  param(
+    [Parameter(Mandatory=$true)][string]$resource,
+    [Parameter(Mandatory=$true)][string]$method,
+    [System.Collections.Hashtable]$kwarg
+  )
+
+  if (!$global:DefaultSscConnection) {
+    Write-Error 'You are not currently connected to any servers. Please connect first using Connect-SscServer.'
+    return;
+  } # end if
+
+  if (!$kwarg) {
+    $body = @{'resource'=$resource; 'method'=$method }
+  } else {
+    $body = @{'resource'=$resource; 'method'=$method; 'kwarg'=$kwarg }
+  }
+
+  try{
+    $jsonBody = $(ConvertTo-Json $body -Depth 4 -Compress )
+    write-debug "JSON Body: $jsonBody"
+    $output = Invoke-WebRequest -WebSession $global:DefaultSscConnection.SscWebSession -Method POST -Uri "https://$($global:DefaultSscConnection.Name)/rpc" -body $jsonBody -ContentType 'application/json'
+    $outputJson = (ConvertFrom-Json $output.Content)
+
+    if ($outputJson.error) { Write-Error $outputJson.error }
+    if ($outputJson.warnings) { Write-Warning $outputJson.warnings }
+    return $outputJson.ret
+
+  } catch {
+    Write-Error $_.Exception.Message
+  }
+}
+
+
+# Lets include a couple sample/helper functions wrappers
+Function Get-SscMaster {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return grain details about the SaltStack Config master node.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData master.get_master_grains.
+  .EXAMPLE
+    PS C:\> Get-SscMaster
+#>
+
+  (Get-SscData master get_master_grains).salt.grains
+}
+
+Function Get-SscMinionCache {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return the grain property cache of SaltStack Config minions.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData minions.get_minion_cache.
+  .EXAMPLE
+    PS C:\> Get-SscMinion
+#>
+
+  (Get-SscData minions get_minion_cache).results
+}
+
+Function Get-SscJob {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return configured SatlStack Config jobs.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData job.get_jobs.
+  .EXAMPLE
+    PS C:\> Get-SscJob
+#>
+
+  (Get-SscData job get_jobs).results
+}
+
+Function Get-SscSchedule {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return schedules for SaltStack Config.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData schedule.get.
+  .EXAMPLE
+    PS C:\> Get-SscSchedule
+#>
+
+  (Get-SscData schedule get).results
+}
+
+Function Get-SscReturn {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return job results from the job cache based on the provided arguments.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData ret.get_returns with either Jid or MinionID.
+  .EXAMPLE
+    PS C:\> Get-SscReturn
+  .EXAMPLE
+    PS C:\> Get-SscReturn -Jid '20211122160147314949'
+  .EXAMPLE
+    PS C:\> Get-SscReturn -MinionID 't147-win22-01.lab.enterpriseadmins.org'
+  .EXAMPLE
+    PS C:\> Get-SscReturn -MinionID 't147-win22-01.lab.enterpriseadmins.org' -Jid '20211122160147314949'
+#>
+  param(
+    [string]$jid,
+    [string]$MinionID
+  )
+  
+  $kwarg = @{}
+  if ($jid) { $kwarg += @{'jid'=$jid} }
+  if ($MinionID) { $kwarg += @{'minion_id'=$MinionID} }
+  
+  (Get-SscData ret get_returns $kwarg).results
+}
+
+Function Get-SscActivity {
+<#
+  .NOTES
+  ===========================================================================
+   Created by:	Brian Wuchner
+   Date:		November 27, 2021
+   Blog:		www.enterpriseadmins.org
+   Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return SaltStack Config commands that have been issued.
+    In the web interface this is similar to the Activity button.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData cmd.get_cmds.
+  .EXAMPLE
+    PS C:\> Get-SscActivity
+#>
+  
+  (Get-SscData cmd get_cmds).results
+}
+
+Function Get-SscFile {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return file contents from the file server based on the provided arguments.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData fs get_file and pass in specified saltenv and path parameters.
+  .EXAMPLE
+    PS C:\> Get-SscFile -saltenv 'sse' -path '/myfiles/file.sls'
+  .EXAMPLE
+    PS C:\> Get-SscFile -fileuuid '5e2483e8-a981-4e8c-9e83-01d1930413db'
+#>
+  param(
+    [Parameter(Mandatory=$true, ParameterSetName='ByFileUUID', ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][Alias('fileuuid')][string]$uuid,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$saltenv,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$path
+  )
+  
+  $kwarg = @{}
+  if ($uuid) { $kwarg += @{'file_uuid'=$uuid } }
+  if ($saltenv) {
+    $kwarg += @{'saltenv'=$saltenv}
+    $kwarg += @{'path'=$path}
+  }
+  
+  if ( Get-SscData fs file_exists $kwarg ) {
+    Get-SscData fs get_file $kwarg
+  } else {
+    if ($uuid) { Write-Error "File with UUID: $uuid not found." } else { Write-Error "File at path $saltenv $path not found." }
+  }
+}
+
+Function Set-SscFile {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will update file contents on the file server based on the provided arguments.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData fs update_file and pass in specified fileuuid or saltenv and path parameters.
+  .EXAMPLE
+    PS C:\> Set-SscFile -saltenv 'sse' -path '/myfiles/file.sls' "#This is my content. `n#And so is this"
+  .EXAMPLE
+    PS C:\> Get-SscFile -saltenv 'sse' -path '/myfiles/file.sls' | Set-SscFile -contenttype 'text/x-yaml'
+#>
+  [cmdletbinding(SupportsShouldProcess=$true,ConfirmImpact='High')]
+  param(
+    [Parameter(Mandatory=$true, ParameterSetName='ByFileUUID', ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][Alias('fileuuid')][string]$uuid,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$saltenv,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$path,
+    [string]$content,
+    [ValidateSet('text/plain','text/x-python','application/json','text/x-yaml')][string]$contenttype
+  )
+  
+  $kwarg = @{}
+  if ($uuid) { $kwarg += @{'file_uuid'=$uuid } }
+  if ($saltenv) {
+    $kwarg += @{'saltenv'=$saltenv}
+    $kwarg += @{'path'=$path}
+  }
+
+  # if the file exists, get its contents based on the correct parameterset.  If it does not exist recommend the correct function.
+  if ( Get-SscData fs file_exists $kwarg ) {
+    if ( $PSCmdlet.ParameterSetName -eq 'ByFileUUID' ) {
+      $currentFile = Get-SscFile -fileuuid $uuid
+    } else {
+      $currentFile = Get-SscFile -saltenv $saltenv -path $path
+    }
+  } else {
+    Write-Error "Specified file does not exist, use New-SscFile instead."
+    return $null
+  }
+
+  if (!$content) { $content = $currentFile.contents }
+  $kwarg += @{'contents'=$content}
+
+  if (!$contenttype) { $contenttype = $currentfile.content_type }
+  $kwarg += @{'content_type'=$contenttype}
+  
+  if ($PSCmdlet.ShouldProcess( "$($currentFile.saltenv)$($currentFile.path) ($($currentFile.uuid))" , 'update')) {
+    Get-SscData fs update_file $kwarg
+  }
+}
+
+Function New-SscFile {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will create a new file on the file server based on the provided arguments.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData fs save_file and pass in specified saltenv and path parameters.
+  .EXAMPLE
+    PS C:\> New-SscFile -saltenv 'sse' -path '/myfiles/file.sls' -content '#this is my file content' -contenttype 'text/plain'
+#>
+  param(
+    [Parameter(Mandatory=$true)][string]$saltenv,
+    [Parameter(Mandatory=$true)][string]$path,
+    [string]$content,
+    [ValidateSet('text/plain','text/x-python','application/json','text/x-yaml')][string]$contenttype
+  )
+  
+  $kwarg = @{}
+  $kwarg += @{'saltenv'=$saltenv}
+  $kwarg += @{'path'=$path}
+
+  # if the file exists, get its contents based on the correct parameterset.  If it does not exist recommend the correct function.
+  if ( Get-SscData fs file_exists $kwarg ) {
+    Write-Error "Specified file already exists, use Set-SscFile instead."
+    return $null
+  }
+
+  if ($content) { $kwarg += @{'contents'=$content} }
+
+  if ($contenttype) {
+    # if a contenttype is passed to the function we'll use it
+    $kwarg += @{'content_type'=$contenttype}
+  } else {
+    # and finally we'll default to text
+    $kwarg += @{'content_type' = 'text/plain' }
+  }
+
+  Get-SscData fs save_file $kwarg
+}
+
+Function Remove-SscFile {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will delete a specified file from the file server based on the provided arguments.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData fs delete_file and pass in specified fileuuid or saltenv and path parameters.
+  .EXAMPLE
+    PS C:\> Remove-SscFile -saltenv 'sse' -path '/myfiles/file.sls'
+  .EXAMPLE
+    PS C:\> Get-SscFile -saltenv 'sse' -path '/myfiles/file.sls' | Remove-SscFile
+#>
+  [cmdletbinding(SupportsShouldProcess=$true,ConfirmImpact='High')]
+  param(
+    [Parameter(Mandatory=$true, ParameterSetName='ByFileUUID', ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][Alias('fileuuid')][string]$uuid,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$saltenv,
+    [Parameter(Mandatory=$true, ParameterSetName='ByFilePath')][string]$path
+  )
+  
+  $kwarg = @{}
+  if ($uuid) { $kwarg += @{'file_uuid'=$uuid } }
+  if ($saltenv) {
+    $kwarg += @{'saltenv'=$saltenv}
+    $kwarg += @{'path'=$path}
+  }
+
+  if ( Get-SscData fs file_exists $kwarg ) {
+    if ($PSCmdlet.ShouldProcess( $(if ($uuid) {$uuid} else {"$saltenv $path"}) , 'delete')) {
+      Get-SscData fs delete_file $kwarg
+    }
+  } else {
+    Write-Error "Specified file does not exist."
+    return $null
+  }
+}
+  
+Function Get-SscLicense {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return license information for SaltStack Config.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData license.get_current_license and return the desc property.
+  .EXAMPLE
+    PS C:\> Get-SscLicense
+#>
+
+  (Get-SscData license get_current_license).desc
+}
+
+Function Get-SscvRALicense {
+<#
+  .NOTES
+  ===========================================================================
+    Created by:	Brian Wuchner
+    Date:		February 12, 2022
+    Blog:		www.enterpriseadmins.org
+    Twitter:		@bwuch
+  ===========================================================================
+  .SYNOPSIS
+    This wrapper function will return vRealize Automation license information for SaltStack Config.
+  .DESCRIPTION
+    This wrapper function will call Get-SscData license.get_vra_license and return the serial and edition property.
+  .EXAMPLE
+    PS C:\> Get-SscvRALicense
+#>
+
+  Get-SscData license get_vra_license
+}
+
+Function Get-SscMinionKey {
+  <#
+    .NOTES
+    ===========================================================================
+      Created by:	Brian Wuchner
+      Date:		February 12, 2022
+      Blog:		www.enterpriseadmins.org
+      Twitter:		@bwuch
+    ===========================================================================
+    .SYNOPSIS
+      This wrapper function will return minion key state information for SaltStack Config.
+    .DESCRIPTION
+      This wrapper function will call Get-SscData minions.get_minion_key_state and return the minions key states.  
+      Optionally a key state can be provided and the results will be filtered to only return the requested state.
+    .EXAMPLE
+      PS C:\> Get-SscMinionKeyState
+    .EXAMPLE
+      PS C:\> Get-SscMinionKeyState -key_state pending
+  #>
+  param(
+    [ValidateSet('accepted','rejected','pending','denied')][string]$state
+  )
+  
+  $kwarg = @{}
+  if ($state) { $kwarg.add('key_state',$state) }
+  
+  (Get-SscData minions get_minion_key_state $kwarg).results
+}
+
+
+Function Set-SscMinionKey {
+  <#
+    .NOTES
+    ===========================================================================
+      Created by:	Brian Wuchner
+      Date:		February 12, 2022
+      Blog:		www.enterpriseadmins.org
+      Twitter:		@bwuch
+    ===========================================================================
+    .SYNOPSIS
+      This wrapper function will set minion key state information for SaltStack Config.
+    .DESCRIPTION
+      This wrapper function will call Get-SscData minions.set_minion_key_state and update the states for specific minions.  
+    .EXAMPLE
+      PS C:\> Get-SscMinionKeyState |?{$_.name -eq 'server2022a'} | Set-SscMinionKeyState -state accept
+    .EXAMPLE
+      PS C:\> Set-SscMinionKeyState -master 'salt' -minion 'server2022a' -state reject -confirm:$false
+  #>
+  [cmdletbinding(SupportsShouldProcess)]
+  param(
+    [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][string]$master,
+    [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][string]$minion,
+    [Parameter(Mandatory, ParameterSetName='accept')][switch]$accept,
+    [Parameter(Mandatory, ParameterSetName='reject')][switch]$reject
+  )
+
+  begin {
+    $collection = @()
+  }
+
+  process {
+    if ($PSCmdlet.ParameterSetName -eq 'accept') { $state = 'accept'}
+    if ($PSCmdlet.ParameterSetName -eq 'reject') { $state = 'reject'}
+    
+    if ($PSCmdlet.ShouldProcess("$master : $minion" , $state)) {
+      $collection += ,@($master, $minion)
+    }
+  }
+  
+  end {
+    $kwarg = @{}
+    $kwarg.Add('state', $state)
+    if ($state -eq 'reject') {$kwarg.Add('include_accepted', $true)}
+    if ($state -eq 'accept') {$kwarg.Add('include_rejected', $true)}
+    if ($state -eq 'accept' -OR $state -eq 'reject') {$kwarg.Add('include_denied',$true)}
+    $kwarg.Add('minions', @( $collection ) )
+
+    (Get-SscData minions set_minion_key_state $kwarg).task_ids
+  }
+}
+
+Function Remove-SscMinionKey {
+  <#
+    .NOTES
+    ===========================================================================
+      Created by:	Brian Wuchner
+      Date:		February 12, 2022
+      Blog:		www.enterpriseadmins.org
+      Twitter:		@bwuch
+    ===========================================================================
+    .SYNOPSIS
+      This wrapper function will delete a minion key for SaltStack Config.
+    .DESCRIPTION
+      This wrapper function will call Get-SscData minions.set_minion_key_state and remove the specified minion keys.  
+    .EXAMPLE
+      PS C:\> Get-SscMinionKeyState |?{$_.name -eq 'server2022a'} | Remove-SscMinionKeyState
+    .EXAMPLE
+      PS C:\> Remove-SscMinionKeyState -master 'salt' -minion 'server2022a' -confirm:$false
+  #>
+  [cmdletbinding(SupportsShouldProcess=$true,ConfirmImpact='High')]
+  param(
+    [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][string]$master,
+    [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)][string]$minion
+  )
+
+  begin {
+    $collection = @()
+  }
+
+  process {
+    if ($PSCmdlet.ShouldProcess("$master : $minion" , 'delete')) {
+      $collection += ,@($master, $minion)
+    }
+  }
+
+  end {
+    $kwarg = @{}
+    $kwarg.Add('state','delete')
+    $kwarg.Add('minions', @( $collection ) )
+
+    (Get-SscData minions set_minion_key_state $kwarg).task_ids
+  }
+}

Modules/Set-CBT/Set-CBT.psm1

@@ -1,15 +1,15 @@
 function Set-CBT {
-<#	
+<#
     .NOTES
     ===========================================================================
     Created by: Markus Kraus
     Twitter: @VMarkus_K
     Private Blog: mycloudrevolution.com
     ===========================================================================
-    Changelog:  
-    2016.11 ver 1.0 Base Release 
+    Changelog:
+    2016.11 ver 1.0 Base Release
     ===========================================================================
-    External Code Sources:  
+    External Code Sources:
     http://wahlnetwork.com/2015/12/01/change-block-tracking-cbt-powercli/
     ===========================================================================
     Tested Against Environment:
@@ -22,13 +22,13 @@ function Set-CBT {
     ===========================================================================
 
     .DESCRIPTION
-    This Function enables or disables CBT.       
+    This Function enables or disables CBT.
 
     .Example
-    Get-VN TST* | Set-CBT -DisableCBT  
+    Get-VN TST* | Set-CBT -DisableCBT
 
     .Example
-    Get-VN TST* | Set-CBT -EnableCBT  
+    Get-VN TST* | Set-CBT -EnableCBT
 
     .PARAMETER DisableCBT
     Disables CBT for any VMs found with it enabled
@@ -41,7 +41,7 @@ function Set-CBT {
 #>
 
   [CmdletBinding()]
-    param( 
+    param(
         [Parameter(Mandatory=$True, ValueFromPipeline=$True, Position=0, HelpMessage = "VMs to process")]
         [ValidateNotNullorEmpty()]
         	[VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl[]] $myVMs,
@@ -52,7 +52,7 @@ function Set-CBT {
         [ValidateNotNullorEmpty()]
             [Switch]$DisableCBT
     )
-Process { 
+Process {
 
 	    $vmconfigspec = New-Object -TypeName VMware.Vim.VirtualMachineConfigSpec
         Write-Verbose -Message "Walking through given VMs"
@@ -60,7 +60,7 @@ Process {
         {
             if ($DisableCBT -and $myVM.ExtensionData.Config.ChangeTrackingEnabled -eq $true -and $myVM.ExtensionData.Snapshot -eq $null)
             {
-                try 
+                try
                 {
                     Write-Verbose -Message "Reconfiguring $($myVM.name) to disable CBT" -Verbose
                     $vmconfigspec.ChangeTrackingEnabled = $false
@@ -75,7 +75,7 @@ Process {
                     }
 
                 }
-                catch 
+                catch
                 {
                     throw $myVM
                 }
@@ -94,13 +94,13 @@ Process {
                     $SnapShot |  Remove-Snapshot -Confirm:$false
                 }
             }
-            else 
+            else
             {
-                if ($myVM.ExtensionData.Snapshot -ne $null -and $EnableCBT) 
+                if ($myVM.ExtensionData.Snapshot -ne $null -and $EnableCBT)
                 {
                     Write-Warning -Message "Skipping $($myVM.name) - Snapshots found"
                 }
-                elseif ($myVM.ExtensionData.Snapshot -ne $null -and $DisableCBT) 
+                elseif ($myVM.ExtensionData.Snapshot -ne $null -and $DisableCBT)
                 {
                     Write-Warning -Message "Skipping $($myVM.name) - Snapshots found"
                 }

Modules/Start-UNMAP/Start-UNMAP.psm1

@@ -1,40 +1,44 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
 function Start-UNMAP {
 <#
 	.SYNOPSIS
     Process SCSI UNMAP on VMware Datastores
-    
+
 	.DESCRIPTION
     This Function will process SCSI UNMAP on VMware Datastores via ESXCLI -V2
 
 	.Example
-    Start-UNMAP -ClusterName myCluster -DSWildcard *RAID5* 
+    Start-UNMAP -ClusterName myCluster -DSWildcard *RAID5*
 
 	.Example
     Start-UNMAP -ClusterName myCluster -DSWildcard *RAID5* -Verbose -WhatIf
 
 	.Notes
 	NAME: Start-UNMAP.psm1
-    AUTHOR: Markus Kraus  
+    AUTHOR: Markus Kraus
 	LASTEDIT: 23.09.2016
 	VERSION: 1.0
 	KEYWORDS: VMware, vSphere, ESXi, SCSI, VAAI, UNMAP
-   
+
 	.Link
 	http://mycloudrevolution.com/
- 
+
  #Requires PS -Version 4.0
  #Requires -Modules VMware.VimAutomation.Core, @{ModuleName="VMware.VimAutomation.Core";ModuleVersion="6.3.0.0"}
  #>
 
     [CmdletBinding(SupportsShouldProcess = $true,ConfirmImpact='High')]
-    param( 
+    param(
         [Parameter(Mandatory=$true, Position=0)]
             [String]$ClusterName,
         [Parameter(Mandatory=$true, Position=1)]
             [String]$DSWildcard
     )
     Process {
-        $Validate = $true 
+        $Validate = $true
         #region: PowerCLI Session Timeout
         Write-Verbose "Set Session Timeout ..."
         $initialTimeout = (Get-PowerCLIConfiguration -Scope Session).WebOperationTimeoutSeconds
@@ -90,10 +94,10 @@ function Start-UNMAP {
         }
         #endregion
 
-    #region: Revert PowerCLI Session Timeout    
+    #region: Revert PowerCLI Session Timeout
     Write-Verbose "Revert Session Timeout ..."
     Set-PowerCLIConfiguration -Scope Session -WebOperationTimeoutSeconds $initialTimeout -Confirm:$False | Out-Null
     #endregion
     }
-    
+
 }

Modules/VAMI/VAMI.psm1

@@ -1,4 +1,9 @@
-Function Get-VAMISummary {
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+Function Get-VAMISummary {
 <#
     .NOTES
     ===========================================================================
@@ -17,7 +22,7 @@
         Get-VAMISummary
 #>
     $systemVersionAPI = Get-CisService -Name 'com.vmware.appliance.system.version'
-    $results = $systemVersionAPI.get() | select product, type, version, build, install_time
+    $results = $systemVersionAPI.get() | select product, type, version, build, install_time, releasedate
 
     $systemUptimeAPI = Get-CisService -Name 'com.vmware.appliance.system.uptime'
     $ts = [timespan]::fromseconds($systemUptimeAPI.get().toString())
@@ -29,6 +34,7 @@
         Version = $results.version;
         Build = $results.build;
         InstallTime = $results.install_time;
+        ReleaseDate = $results.releasedate;
         Uptime = $uptime
     }
     $summaryResult
@@ -109,6 +115,7 @@ Function Get-VAMIAccess {
         Console = $consoleAccess;
         DCUI = $dcuiAccess;
         BashShell = $shellAccess.enabled;
+        BashTimeout = $shellAccess.timeout;
         SSH = $sshAccess
     }
     $accessResult
@@ -122,7 +129,10 @@ Function Get-VAMITime {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
-	===========================================================================
+     Modifed by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 16, 2020
+    ===========================================================================
     .SYNOPSIS
         This function retrieves the time and NTP info from VAMI interface (5480)
         for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
@@ -131,12 +141,16 @@ Function Get-VAMITime {
     .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
         Get-VAMITime
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs
 #>
-    $systemTimeAPI = Get-CisService -Name 'com.vmware.appliance.system.time'
+    $systemTimeAPI = ( Get-VAMIServiceAPI -NameFilter "system.time")
     $timeResults = $systemTimeAPI.get()
 
-    $timeSync = (Get-CisService -Name 'com.vmware.appliance.techpreview.timesync').get()
-    $timeSyncMode = $timeSync.mode
+    $timeSyncMode = ( Get-VAMIServiceAPI -NameFilter "timesync").get()
+    if ($timeSyncMode.mode) {
+        $timeSyncMode = $timeSync.mode
+    }
 
     $timeResult  = [pscustomobject] @{
         Timezone = $timeResults.timezone;
@@ -148,13 +162,84 @@ Function Get-VAMITime {
     }
 
     if($timeSyncMode -eq "NTP") {
-        $ntpServers = (Get-CisService -Name 'com.vmware.appliance.techpreview.ntp').get()
-        $timeResult.NTPServers = $ntpServers.servers
-        $timeResult.NTPStatus = $ntpServers.status
+        $ntpServers = ( Get-VAMIServiceAPI -NameFilter "ntp").get()
+        if ($ntpServers.servers) {
+            $timeResult.NTPServers = $ntpServers.servers
+            $timeResult.NTPStatus = $ntpServers.status
+        } else {
+            $timeResult.NTPServers = $ntpServers
+            $timeResult.NTPStatus = ( Get-VAMIServiceAPI -NameFilter "ntp").test(( Get-VAMIServiceAPI -NameFilter "ntp").get()).status
+        }
     }
     $timeResult
 }
 
+Function Set-VAMITimeSync {
+<#
+    .NOTES
+    ===========================================================================
+     Inspired by:   William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+     Created by:    Michael Dunsdon
+     Twitter:       @MJDunsdon
+     Date:          September 21, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function sets the time and NTP info from VAMI interface (5480)
+        for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
+    .DESCRIPTION
+        Function to return current Time and NTP information
+    .EXAMPLE
+        Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
+        Set-VAMITimeSync -SyncMode "NTP" -TimeZone "US/Pacific" -NTPServers "10.0.0.10,10.0.0.11,10.0.0.12"
+    .NOTES
+        Create script to Set NTP for Newer VCSA. Script supports 6.7 VCSAs
+#>
+    param(
+        [Parameter(Mandatory=$true)]
+        [ValidateSet('Disabled', 'NTP', 'Host')]
+        [String]$SyncMode,
+        [Parameter(Mandatory=$False,HelpMessage="TimeZone Name needs to be in Posix Naming / Unix format")]
+        [String]$TimeZone,
+        [Parameter(Mandatory=$false,HelpMessage="NTP Servers need to be either a string separated by ',' or an array of servers")]
+        $NTPServers
+    )
+
+    $timeSyncMode = ( Get-VAMIServiceAPI -NameFilter "timesync").get()
+    if ($timeSyncMode.gettype().name -eq "PSCustomObject") {
+        if ($SyncMode.ToUpper() -ne $timeSyncMode.mode.toupper()) {
+          $timesyncapi = (Get-VAMIServiceAPI -NameFilter "timesync")
+          $timesyncconfig = $timesyncapi.help.set.config.createexample()
+          $timesyncconfig = $Sync
+          $timesyncapi.set($timesyncconfig)
+        }
+    } else {
+        if ($SyncMode.ToUpper() -ne $timeSyncMode.toupper()) {
+            $timesyncapi = (Get-VAMIServiceAPI -NameFilter "timesync")
+            $timesyncapi.set($Sync)
+        }
+        if ($NTPServers) {
+            $ntpapi = (Get-VAMIServiceAPI -NameFilter "ntp")
+            if ($NTPServers.gettype().Name -eq "String") {
+                $NTPServersArray = ($NTPServers -split ",").trim()
+            } else {
+                 $NTPServersArray = $NTPServers
+            }
+            if ($NTPServersArray -ne $ntpapi.get()) {
+                $ntpapi.set($NTPServersArray)
+            }
+        }
+        if ($TimeZone) {
+            $timezoneapi = (Get-VAMIServiceAPI -NameFilter "timezone")
+            if ($TimeZone -ne ($timezoneapi.get())) {
+                $timezoneapi.set($TimeZone)
+            }
+        }
+    }
+}
+
 Function Get-VAMINetwork {
 <#
     .NOTES
@@ -163,6 +248,9 @@ Function Get-VAMINetwork {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
+     Modifed by:    Michael Dunsdon, Mathieu Allegret
+     Twitter:      @MJDunsdon
+     Date:         September 21, 2020
 	===========================================================================
     .SYNOPSIS
         This function retrieves network information from VAMI interface (5480)
@@ -172,31 +260,35 @@ Function Get-VAMINetwork {
     .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
         Get-VAMINetwork
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs
 #>
     $netResults = @()
 
-    $Hostname = (Get-CisService -Name 'com.vmware.appliance.networking.dns.hostname').get()
-    $dns = (Get-CisService -Name 'com.vmware.appliance.networking.dns.servers').get()
+    $Hostname = (Get-VAMIServiceAPI -NameFilter "dns.hostname").get()
+    $dns = (Get-VAMIServiceAPI -NameFilter "dns.servers").get()
 
-    Write-Host "Hostname: " $hostname
-    Write-Host "DNS Servers: " $dns.servers
-
-    $interfaces = (Get-CisService -Name 'com.vmware.appliance.networking.interfaces').list()
+    $interfaces = (Get-VAMIServiceAPI -NameFilter "interfaces").list()
     foreach ($interface in $interfaces) {
-        $ipv4API = (Get-CisService -Name 'com.vmware.appliance.techpreview.networking.ipv4')
-        $spec = $ipv4API.Help.get.interfaces.CreateExample()
-        $spec+= $interface.name
-        $ipv4result = $ipv4API.get($spec)
-
+        $ipv4API = (Get-VAMIServiceAPI -NameFilter "ipv4")
+        if ($ipv4API.help.get.psobject.properties.name -like "*_*") {
+            $ipv4result = $ipv4API.get($interface.Name)
+            $Updateable = $ipv4result.configurable
+        } else {
+            $ipv4result = $ipv4API.get(@($interface.Name))
+            $Updateable = $ipv4result.updateable
+        }
         $interfaceResult = [pscustomobject] @{
-            Inteface =  $interface.name;
-            MAC = $interface.mac;
-            Status = $interface.status;
-            Mode = $ipv4result.mode;
-            IP = $ipv4result.address;
-            Prefix = $ipv4result.prefix;
-            Gateway = $ipv4result.default_gateway;
-            Updateable = $ipv4result.updateable
+	    Hostname = $Hostname
+            Inteface = $interface.name
+            MAC = $interface.mac
+            Status = $interface.status
+            Mode = $ipv4result.mode
+            IP = $ipv4result.address
+            Prefix = $ipv4result.prefix
+            Gateway = $ipv4result.default_gateway
+	    DNSServers = $dns.servers
+            Updateable = $Updateable
         }
         $netResults += $interfaceResult
     }
@@ -224,8 +316,8 @@ Function Get-VAMIDisks {
     $storageAPI = Get-CisService -Name 'com.vmware.appliance.system.storage'
     $disks = $storageAPI.list()
 
-    foreach ($disk in $disks | sort {[int]$_.disk.toString()}) {
-        $disk | Select Disk, Partition
+    foreach ($disk in $disks | Sort-Object {[int]$_.disk.toString()}) {
+        $disk | Select-Object Disk, Partition
     }
 }
 
@@ -286,6 +378,9 @@ Function Get-VAMIStorageUsed {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
+     Modifed by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 16, 2020
 	===========================================================================
     .SYNOPSIS
         This function retrieves the individaul OS partition storage utilization
@@ -295,70 +390,49 @@ Function Get-VAMIStorageUsed {
     .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
         Get-VAMIStorageUsed
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs.
+        Also modifed the static list of filesystems to be more dynamic in nature to account for the differences in VCSA versions.
 #>
+
     $monitoringAPI = Get-CisService 'com.vmware.appliance.monitoring'
     $querySpec = $monitoringAPI.help.query.item.CreateExample()
 
     # List of IDs from Get-VAMIStatsList to query
-    $querySpec.Names = @(
-    "storage.used.filesystem.autodeploy",
-    "storage.used.filesystem.boot",
-    "storage.used.filesystem.coredump",
-    "storage.used.filesystem.imagebuilder",
-    "storage.used.filesystem.invsvc",
-    "storage.used.filesystem.log",
-    "storage.used.filesystem.netdump",
-    "storage.used.filesystem.root",
-    "storage.used.filesystem.updatemgr",
-    "storage.used.filesystem.vcdb_core_inventory",
-    "storage.used.filesystem.vcdb_seat",
-    "storage.used.filesystem.vcdb_transaction_log",
-    "storage.totalsize.filesystem.autodeploy",
-    "storage.totalsize.filesystem.boot",
-    "storage.totalsize.filesystem.coredump",
-    "storage.totalsize.filesystem.imagebuilder",
-    "storage.totalsize.filesystem.invsvc",
-    "storage.totalsize.filesystem.log",
-    "storage.totalsize.filesystem.netdump",
-    "storage.totalsize.filesystem.root",
-    "storage.totalsize.filesystem.updatemgr",
-    "storage.totalsize.filesystem.vcdb_core_inventory",
-    "storage.totalsize.filesystem.vcdb_seat",
-    "storage.totalsize.filesystem.vcdb_transaction_log"
-    )
+    $querySpec.Names = ($monitoringAPI.list() | Where-Object {($_.name -like "*storage.used.filesystem*") -or ($_.name -like "*storage.totalsize.filesystem*") } | Select-Object id | Sort-Object -Property id).id.value
 
     # Tuple (Filesystem Name, Used, Total) to store results
     $storageStats = @{
+    "archive"=@{"name"="/storage/archive";"used"=0;"total"=0};
     "autodeploy"=@{"name"="/storage/autodeploy";"used"=0;"total"=0};
     "boot"=@{"name"="/boot";"used"=0;"total"=0};
-    "coredump"=@{"name"="/storage/core";"used"=0;"total"=0};
+    "core"=@{"name"="/storage/core";"used"=0;"total"=0};
     "imagebuilder"=@{"name"="/storage/imagebuilder";"used"=0;"total"=0};
     "invsvc"=@{"name"="/storage/invsvc";"used"=0;"total"=0};
     "log"=@{"name"="/storage/log";"used"=0;"total"=0};
     "netdump"=@{"name"="/storage/netdump";"used"=0;"total"=0};
     "root"=@{"name"="/";"used"=0;"total"=0};
     "updatemgr"=@{"name"="/storage/updatemgr";"used"=0;"total"=0};
-    "vcdb_core_inventory"=@{"name"="/storage/db";"used"=0;"total"=0};
-    "vcdb_seat"=@{"name"="/storage/seat";"used"=0;"total"=0};
-    "vcdb_transaction_log"=@{"name"="/storage/dblog";"used"=0;"total"=0}
+    "db"=@{"name"="/storage/db";"used"=0;"total"=0};
+    "seat"=@{"name"="/storage/seat";"used"=0;"total"=0};
+    "dblog"=@{"name"="/storage/dblog";"used"=0;"total"=0};
+    "swap"=@{"name"="swap";"used"=0;"total"=0}
     }
 
     $querySpec.interval = "DAY1"
     $querySpec.function = "MAX"
-    $querySpec.start_time = ((get-date).AddDays(-1))
+    $querySpec.start_time = ((Get-Date).AddDays(-1))
     $querySpec.end_time = (Get-Date)
-    $queryResults = $monitoringAPI.query($querySpec) | Select * -ExcludeProperty Help
+    $queryResults = $monitoringAPI.query($querySpec) | Select-Object * -ExcludeProperty Help
 
     foreach ($queryResult in $queryResults) {
         # Update hash if its used storage results
+        $key = ((($queryResult.name).toString()).split(".")[-1]) -replace "coredump","core" -replace "vcdb_","" -replace "core_inventory","db" -replace "transaction_log","dblog"
+        $value = [Math]::Round([int]($queryResult.data[1]).toString()/1MB,2)
         if($queryResult.name -match "used") {
-            $key = (($queryResult.name).toString()).split(".")[-1]
-            $value = [Math]::Round([int]($queryResult.data[1]).toString()/1MB,2)
             $storageStats[$key]["used"] = $value
         # Update hash if its total storage results
         } else {
-            $key = (($queryResult.name).toString()).split(".")[-1]
-            $value = [Math]::Round([int]($queryResult.data[1]).toString()/1MB,2)
             $storageStats[$key]["total"] = $value
         }
     }
@@ -406,7 +480,6 @@ Function Get-VAMIService {
 
     if($Name -ne "") {
         $vMonAPI = Get-CisService 'com.vmware.appliance.vmon.service'
-
         try {
             $serviceStatus = $vMonAPI.get($name,0)
             $serviceString = [pscustomobject] @{
@@ -423,7 +496,6 @@ Function Get-VAMIService {
     } else {
         $vMonAPI = Get-CisService 'com.vmware.appliance.vmon.service'
         $services = $vMonAPI.list_details()
-
         $serviceResult = @()
         foreach ($key in $services.keys | Sort-Object -Property Value) {
             $serviceString = [pscustomobject] @{
@@ -448,7 +520,7 @@ Function Start-VAMIService {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
-	===========================================================================
+    ===========================================================================
     .SYNOPSIS
         This function retrieves list of services in VAMI interface (5480)
         for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
@@ -470,8 +542,8 @@ Function Start-VAMIService {
     $vMonAPI = Get-CisService 'com.vmware.appliance.vmon.service'
 
     try {
-        Write-Host "Starting $name service ..."
-        $vMonAPI.start($name)
+        Write-Host "Starting $Name service ..."
+        $vMonAPI.start($Name)
     } catch {
         Write-Error $Error[0].exception.Message
     }
@@ -507,8 +579,8 @@ Function Stop-VAMIService {
     $vMonAPI = Get-CisService 'com.vmware.appliance.vmon.service'
 
     try {
-        Write-Host "Stopping $name service ..."
-        $vMonAPI.stop($name)
+        Write-Host "Stopping $Name service ..."
+        $vMonAPI.stop($Name)
     } catch {
         Write-Error $Error[0].exception.Message
     }
@@ -556,15 +628,20 @@ Function Get-VAMIUser {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
-	===========================================================================
-	.SYNOPSIS
-		This function retrieves VAMI local users using VAMI interface (5480)
+     Modifed by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 16, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function retrieves VAMI local users using VAMI interface (5480)
         for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
-	.DESCRIPTION
-		Function to retrieve VAMI local users
-	.EXAMPLE
+    .DESCRIPTION
+        Function to retrieve VAMI local users
+    .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
         Get-VAMIUser
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs.
 #>
     param(
         [Parameter(
@@ -575,42 +652,57 @@ Function Get-VAMIUser {
         [String]$Name
     )
 
-    $userAPI = Get-CisService 'com.vmware.appliance.techpreview.localaccounts.user'
+    $userAPI = Get-VAMIServiceAPI -NameFilter "accounts"
+    $UserResults = @()
 
-    $userResults = @()
+    # Get a list of users
+    try {
+        $Users = $UserAPI.list()
+    } catch {
+        write-error $_
+    }
 
-    if($Name -ne "") {
-        try {
-            $user = $userAPI.get($name)
+    # Apply filtering if Name input is provided
+    if ($Name -ne '' -AND $Name -ne $null) {
+        # For 6.5 API, the username is part of the list returnset; for 6.7/7.x API the value from the list is the username. Because of this we will use an OR filter to account for either case.
+        $Users = $Users | Where-Object {$_.username -eq $name -OR $_.value -eq $name}
+    }
 
-            $userString = [pscustomobject] @{
-                User = $user.username
-                Name = $user.fullname
-                Email = $user.email
-                Status = $user.status
-                PasswordStatus = $user.passwordstatus
-                Role = $user.role
+    if ($Users.status) {
+        # This is for 6.5 API, which has a status property; in newer API response there is an enabled property with values of True/False
+        foreach ($User in $Users) {
+            $UserString = [pscustomobject] @{
+                User = $User.username
+                Name = $User.fullname
+                Email = $User.email
+                Enabled = if ($User.status -eq 'enabled' ) { $true } else { $false }
+                Status = $User.status
+                LastPasswordChange = $null
+                PasswordExpiresAt = $null
+                PasswordStatus = $User.passwordstatus
+                Roles = @($User.role)
             }
-            $userResults += $userString
-        } catch {
-            Write-Error $Error[0].exception.Message
+            $UserResults += $UserString
         }
     } else {
-        $users = $userAPI.list()
-
-        foreach ($user in $users) {
-            $userString = [pscustomobject] @{
-                User = $user.username
-                Name = $user.fullname
-                Email = $user.email
-                Status = $user.status
-                PasswordStatus = $user.passwordstatus
-                Role = $user.role
+        # This is for 6.7/7.0+ API response
+        foreach ($User in $Users) {
+            $UserInfo = $userAPI.get($User.Value)
+            $UserString = [pscustomobject] @{
+                User = $User.value
+                Name = $UserInfo.fullname
+                Email = $UserInfo.email
+                Enabled = $UserInfo.enabled
+                Status = if ($userInfo.enabled ) { 'enabled' } else { 'disabled' }
+                LastPasswordChange = $UserInfo.last_password_change
+                PasswordExpiresAt = $UserInfo.password_expires_at
+                PasswordStatus = if ($UserInfo.has_password) { if ((!!$UserInfo.password_expires_at) -and ( (Get-Date) -lt [datetime]$UserInfo.password_expires_at)) {'valid'} else {'expired'}} else { 'notset'}
+                Roles = $UserInfo.roles
             }
-            $userResults += $userString
+            $UserResults += $UserString
         }
     }
-    $userResults
+    $UserResults
 }
 
 Function New-VAMIUser {
@@ -621,53 +713,148 @@ Function New-VAMIUser {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
-	===========================================================================
-	.SYNOPSIS
-		This function to create new VAMI local user using VAMI interface (5480)
+     Modifed by:    Michael Dunsdon
+     Twitter:       @MJDunsdon
+     Date:          September 16, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function to create new VAMI local user using VAMI interface (5480)
         for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
-	.DESCRIPTION
-		Function to create a new VAMI local user
-	.EXAMPLE
+    .DESCRIPTION
+        Function to create a new VAMI local user
+    .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
-        New-VAMIUser -name lamw -fullname "William Lam" -role "operator" -email "lamw@virtuallyghetto.com" -password "VMware1!"
+        New-VAMIUser -name lamw -fullname "William Lam" -role "operator" -email "lamw@virtuallyghetto.com" -password "VMware1!" -passwordexpires  -passwordexpiresat "1/1/1970" -maxpasswordage 90
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs.
+        Also added new Parameters to script.
 #>
     param(
-        [Parameter(
-            Mandatory=$true)
-        ]
-        [String]$name,
-        [Parameter(
-            Mandatory=$true)
-        ]
-        [String]$fullname,
-        [Parameter(
-            Mandatory=$true)
-        ]
-        [ValidateSet("admin","operator","superAdmin")][String]$role,
-        [Parameter(
-            Mandatory=$false)
-        ]
-        [String]$email="",
-        [Parameter(
-            Mandatory=$true)
-        ]
-        [String]$password
+        [Parameter(Mandatory=$true)]
+        [String]$Name,
+        [Parameter(Mandatory=$true)]
+        [String]$FullName,
+        [Parameter(Mandatory=$true)]
+        [ValidateSet("admin","operator","superAdmin")]
+        [String]$Role,
+        [Parameter(Mandatory=$false)]
+        [String]$Email="",
+        [Parameter(Mandatory=$true)]
+        [String]$Password,
+        [Parameter(Mandatory=$false)]
+        [switch]$PasswordExpires,
+        [Parameter(Mandatory=$false)]
+        [String]$PasswordExpiresAt = $null,
+        [Parameter(Mandatory=$false)]
+        [String]$MaxPasswordAge = 90
     )
 
-    $userAPI = Get-CisService 'com.vmware.appliance.techpreview.localaccounts.user'
-    $createSpec = $userAPI.Help.add.config.CreateExample()
+    $userAPI = Get-VAMIServiceAPI -NameFilter "accounts"
+    if ($userAPI.name -eq 'com.vmware.appliance.techpreview.localaccounts.user') {
+        $CreateSpec = $UserAPI.Help.add.config.Create()
+    } else {
+        $CreateSpec = $UserAPI.Help.create.config.Create()
+    }
 
-    $createSpec.username = $name
-    $createSpec.fullname = $fullname
-    $createSpec.role = $role
-    $createSpec.email = $email
-    $createSpec.password = [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$password
+    $CreateSpec.email = $Email
+    $CreateSpec.password = [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$Password
 
-    try {
-        Write-Host "Creating new user $name ..."
-        $userAPI.add($createSpec)
-    } catch {
-        Write-Error $Error[0].exception.Message
+    if ($CreateSpec.psobject.properties.name -contains "username") {
+        # This is for 6.5 API
+        $CreateSpec.username = $Name
+        $CreateSpec.fullname = $FullName
+        $CreateSpec.role = $Role
+        try {
+            Write-Host "Creating new user $Name ..."
+            $UserAPI.add($CreateSpec)
+        } catch {
+            Write-Error $Error[0].exception.Message
+        }
+    } else {
+        # This is for 6.7/7.0+ API
+        $CreateSpec.full_name = $FullName
+        $CreateSpec.roles = @($Role)
+        $CreateSpec.password_expires = [string]$PasswordExpires
+        $CreateSpec.password_expires_at = $PasswordExpiresAt
+        $CreateSpec.max_days_between_password_change = $MaxPasswordAge
+        try {
+            Write-Host "Creating new user $Name ..."
+            $UserAPI.create($Name, $CreateSpec)
+        } catch {
+            Write-Error $_
+        }
+    }
+}
+
+Function Update-VAMIUser {
+<#
+    .NOTES
+    ===========================================================================
+     Inspired by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+     Created by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 21, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function to update fields of a VAMI local user using VAMI interface (5480)
+        for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
+    .DESCRIPTION
+        Function to update fields of a VAMI local user
+    .EXAMPLE
+        Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
+        Update-VAMIUser -name lamw -fullname "William Lam" -role "operator" -email "lamw@virtuallyghetto.com" -password "VMware1!" -passwordexpires  -passwordexpiresat "1/1/1970" -maxpasswordage 90
+    .NOTES
+        Created script to allow updating of an exisiting user account. Script supports 6.5 and 6.7 VCSAs.
+#>
+    param(
+        [Parameter(Mandatory=$true)]
+        [String]$Name,
+        [Parameter(Mandatory=$false)]
+        [String]$FullName,
+        [Parameter(Mandatory=$false)]
+        [ValidateSet("admin","operator","superAdmin")]
+        [String]$Role,
+        [Parameter(Mandatory=$false)]
+        [String]$Email="",
+        [Parameter(Mandatory=$false)]
+        [String]$Password = $null,
+        [Parameter(Mandatory=$false)]
+        [switch]$PasswordExpires,
+        [Parameter(Mandatory=$false)]
+        [String]$PasswordExpiresAt = $null,
+        [Parameter(Mandatory=$false)]
+        [String]$MaxPasswordAge = 90
+    )
+
+    $userAPI = Get-VAMIServiceAPI -NameFilter "accounts"
+    $UpdateSpec = $UserAPI.Help.set.config.CreateExample()
+
+    $UpdateSpec.fullname = $FullName
+    $UpdateSpec.role = $Role
+    $UpdateSpec.email = $Email
+
+    if ($UpdateSpec.psobject.properties.name -contains "username") {
+        $UpdateSpec.username = $Name
+        try {
+            Write-Host "Updating Settings for user $Name ..."
+            $UserAPI.set($UpdateSpec)
+        } catch {
+            Write-Error $Error[0].exception.Message
+        }
+    } else {
+        $UpdateSpec.password = [VMware.VimAutomation.Cis.Core.Types.V1.Secret]$Password
+        $UpdateSpec.password_expires = $PasswordExpires
+        $UpdateSpec.password_expires_at = $PasswordExpiresAt
+        $UpdateSpec.max_days_between_password_change = $MaxPasswordAge
+        try {
+            Write-Host "Updating Settings for user $Name ..."
+            $UserAPI.update($Name, $UpdateSpec)
+        } catch {
+            Write-Error $Error[0].exception.Message
+        }
     }
 }
 
@@ -679,32 +866,30 @@ Function Remove-VAMIUser {
      Organization:  VMware
      Blog:          www.virtuallyghetto.com
      Twitter:       @lamw
-	===========================================================================
-	.SYNOPSIS
-		This function to remove VAMI local user using VAMI interface (5480)
+     Modifed by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 21, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function to remove VAMI local user using VAMI interface (5480)
         for a VCSA node which can be an Embedded VCSA, External PSC or External VCSA.
-	.DESCRIPTION
-		Function to remove VAMI local user
-	.EXAMPLE
+    .DESCRIPTION
+        Function to remove VAMI local user
+    .EXAMPLE
         Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
         Get-VAMIAccess
+    .NOTES
+        Modified script to account for Newer VCSA. Script supports 6.5 and 6.7 VCSAs.
 #>
+    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
     param(
-        [Parameter(
-            Mandatory=$true)
-        ]
-        [String]$name,
-        [Parameter(
-            Mandatory=$false)
-        ]
-        [boolean]$confirm=$false
+        [Parameter(Mandatory=$true)]
+        [String]$Name
     )
-
-    if(!$confirm) {
-        $answer = Read-Host -Prompt "Do you want to delete user $name (Y or N)"
-        if($answer -eq "Y" -or $answer -eq "y") {
-            $userAPI = Get-CisService 'com.vmware.appliance.techpreview.localaccounts.user'
-
+    Begin {}
+    Process{
+        if($PSCmdlet.ShouldProcess($Name,'Delete')) {
+            $userAPI =  Get-VAMIServiceAPI -NameFilter "accounts"
             try {
                 Write-Host "Deleting user $name ..."
                 $userAPI.delete($name)
@@ -713,4 +898,41 @@ Function Remove-VAMIUser {
             }
         }
     }
-}
+    End{}
+}
+
+Function Get-VAMIServiceAPI {
+<#
+    .NOTES
+    ===========================================================================
+     Inspired by:    William Lam
+     Organization:  VMware
+     Blog:          www.virtuallyghetto.com
+     Twitter:       @lamw
+     Created by:    Michael Dunsdon
+     Twitter:      @MJDunsdon
+     Date:         September 21, 2020
+    ===========================================================================
+    .SYNOPSIS
+        This function returns the Service Api Based on a String of Service Name.
+    .DESCRIPTION
+        Function to find and get service api based on service name string
+    .EXAMPLE
+        Connect-CisServer -Server 192.168.1.51 -User administrator@vsphere.local -Password VMware1!
+        Get-VAMIUser -NameFilter "accounts"
+    .NOTES
+        Script supports 6.5 and 6.7 VCSAs.
+        Function Gets all Service Api Names and filters the list based on NameFilter
+        If Multiple Serivces are returned it takes the Top one.
+#>
+    param(
+        [Parameter(Mandatory=$true)]
+        [String]$NameFilter
+    )
+
+    $ServiceAPI = Get-CisService | Where-Object {$_.name -like "*$($NameFilter)*"}
+    if (($ServiceAPI.count -gt 1) -and $NameFilter) {
+        $ServiceAPI = ($ServiceAPI | Sort-Object -Property Name)[0]
+    }
+    return $ServiceAPI
+}

Modules/VCHA/VCHA.psm1

@@ -1,3 +1,7 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
 Function Get-VCHAConfig {
 <#
     .NOTES

Modules/VCSA/VCSA.psm1

@@ -0,0 +1,72 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Get-VCSAPasswordPolicy {
+<#
+    .DESCRIPTION Retrieves vCenter Server Appliance SSO and Local OS Password Policy Configuration
+    .NOTES  Author:  William Lam
+    .PARAMETER VCSAName
+        Inventory name of the VCSA VM
+    .PARAMETER VCSARootPassword
+        Root password for VCSA VM
+    .PARAMETER SSODomain
+        SSO Domain of the VCSA VM
+    .PARAMETER SSOPassword
+        Administrator password for the SSO Domain of the VCSA VM
+    .EXAMPLE
+        Get-VCSAPasswordPolicy -VCSAName "MGMT-VCSA-01" -VCSARootPassword "VMware1!" -SSODomain "vsphere.local" -SSOPassword "VMware1!"
+#>
+    Param (
+        [Parameter(Mandatory=$true)][String]$VCSAName,
+        [Parameter(Mandatory=$true)][String]$VCSARootPassword,
+        [Parameter(Mandatory=$true)][String]$SSODomain,
+        [Parameter(Mandatory=$true)][String]$SSOPassword
+    )
+
+    $vm = Get-Vm -Name $VCSAName
+
+    if($vm) {
+        $a,$b = $SSODomain.split(".")
+
+        $ssoPasswordPolicy = Invoke-VMScript -ScriptText "/opt/likewise/bin/ldapsearch -h localhost -w $SSOPassword -x -D `"cn=Administrator,cn=Users,dc=$a,dc=$b`" -b `"cn=password and lockout policy,dc=$a,dc=$b`" | grep vmwPassword" -vm $vm -GuestUser "root" -GuestPassword $VCSARootPassword
+        $localOSPasswordPolicy = Invoke-VMScript -ScriptText "cat /etc/login.defs | grep -v '#' | grep PASS" -vm $vm -GuestUser "root" -GuestPassword $VCSARootPassword
+
+        Write-Host -ForegroundColor green "`nSSO Password Policy: "
+        $ssoPasswordPolicy
+
+        Write-Host -ForegroundColor green "`nLocalOS Password Policy: "
+        $localOSPasswordPolicy
+    } else {
+        Write-Host "`nUnable to find VCSA named $VCSAName"
+    }
+}
+
+Function Get-VCSAIdentitySource {
+<#
+    .DESCRIPTION Retrieves vCenter Server Appliance Identity Source Configuration
+    .NOTES  Author:  William Lam
+    .PARAMETER VCSAName
+        Inventory name of the VCSA VM
+    .PARAMETER VCSARootPassword
+        Root password for VCSA VM
+    .EXAMPLE
+        Get-VCSAIdentitySource -VCSAName "MGMT-VCSA-01" -VCSARootPassword "VMware1!"
+#>
+    Param (
+        [Parameter(Mandatory=$true)][String]$VCSAName,
+        [Parameter(Mandatory=$true)][String]$VCSARootPassword
+    )
+
+    $vm = Get-Vm -Name $VCSAName
+
+    if($vm) {
+        $identitySources = Invoke-VMScript -ScriptText "/opt/vmware/bin/sso-config.sh -get_identity_sources 2> /dev/null | sed -ne '/^*/,$ p'" -vm $vm -GuestUser "root" -GuestPassword $VCSARootPassword
+
+        Write-Host -ForegroundColor green "`nIdentity Sources: "
+        $identitySources
+
+    } else {
+        Write-Host "`nUnable to find VCSA named $VCSAName"
+    }
+}

Modules/VISecret/README.md

@@ -0,0 +1,7 @@
+# Example module for using SecretManagement and SecretStore to save PowerCLI credentials
+
+
+
+This module demonstrates how users can use the the Microsoft.PowerShell.SecretManagement and Microsoft.PowerShell.SecretStore modules to save their PowerCLI credentials. 
+
+The module supports PowerShell 5.1 and PowerShell 7.0 and above.

Modules/VISecret/VMware.VISecret.psd1

@@ -0,0 +1,138 @@
+#
+# Module manifest for module 'VMware.VISecret'
+#
+
+@{
+
+    # Script module or binary module file associated with this manifest.
+    RootModule = 'VMware.VISecret.psm1'
+    
+    # Version number of this module.
+    ModuleVersion = '1.0.0.0'
+    
+    # Supported PSEditions
+    CompatiblePSEditions = @('Desktop', 'Core')
+    
+    # ID used to uniquely identify this module
+    GUID = '66124b00-4095-4a1f-9940-f91622009b15'
+    
+    # Author of this module
+    Author = 'VMware'
+    
+    # Company or vendor of this module
+    CompanyName = 'VMware'
+    
+    # Copyright statement for this module
+    Copyright = 'Copyright (c) VMware, Inc. All rights reserved.'
+    
+    # Description of the functionality provided by this module
+    Description = 'Module to enable easy use of Microsoft.PowerShell.SecretManagement module in VMware context'
+    
+    # Minimum version of the PowerShell engine required by this module
+    PowerShellVersion = '5.1'
+    
+    # Name of the PowerShell host required by this module
+    # PowerShellHostName = ''
+    
+    # Minimum version of the PowerShell host required by this module
+    # PowerShellHostVersion = ''
+    
+    # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # DotNetFrameworkVersion = ''
+    
+    # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # ClrVersion = ''
+    
+    # Processor architecture (None, X86, Amd64) required by this module
+    # ProcessorArchitecture = ''
+    
+    # Modules that must be imported into the global environment prior to importing this module
+    RequiredModules = @(
+    @{"ModuleName"="VMware.VimAutomation.Core";"ModuleVersion"="1.0.0.0"}
+    @{"ModuleName"="Microsoft.PowerShell.SecretManagement";"ModuleVersion"="1.1.2"}
+    @{"ModuleName"="Microsoft.PowerShell.SecretStore";"ModuleVersion"="1.0.6"}
+    )
+    
+    # Assemblies that must be loaded prior to importing this module
+    # RequiredAssemblies = @()
+    
+    # Script files (.ps1) that are run in the caller's environment prior to importing this module.
+    # ScriptsToProcess = @()
+    
+    # Type files (.ps1xml) to be loaded when importing this module
+    # TypesToProcess = @()
+    
+    # Format files (.ps1xml) to be loaded when importing this module
+    #FormatsToProcess = @()
+    
+    # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+    # NestedModules = @()
+    
+    # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+    FunctionsToExport = @(
+        'Initialize-VISecret',
+        'New-VISecret',
+        'Get-VISecret',
+        'Remove-VISecret',
+        'Connect-VIServerWithSecret'
+    )
+    
+    # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+    CmdletsToExport = @()
+    
+    # Variables to export from this module
+    VariablesToExport = @()
+    
+    # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+    AliasesToExport = @()
+    
+    # DSC resources to export from this module
+    # DscResourcesToExport = @()
+    
+    # List of all modules packaged with this module
+    # ModuleList = @()
+    
+    # List of all files packaged with this module
+    # FileList = @()
+    
+    # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+    PrivateData = @{
+    
+        PSData = @{
+    
+            # Tags applied to this module. These help with module discovery in online galleries.
+            # Tags = @()
+    
+            # A URL to the license for this module.
+            # LicenseUri = ''
+    
+            # A URL to the main website for this project.
+            # ProjectUri = ''
+    
+            # A URL to an icon representing this module.
+            # IconUri = ''
+    
+            # ReleaseNotes of this module
+            # ReleaseNotes = ''
+    
+            # Prerelease string of this module
+            # Prerelease = ''
+    
+            # Flag to indicate whether the module requires explicit user acceptance for install/update/save
+            # RequireLicenseAcceptance = $false
+    
+            # External dependent modules of this module
+            # ExternalModuleDependencies = @()
+    
+        } # End of PSData hashtable
+    
+    } # End of PrivateData hashtable
+    
+    # HelpInfo URI of this module
+    # HelpInfoURI = ''
+    
+    # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+    # DefaultCommandPrefix = ''
+    
+    }
+    

Modules/VISecret/VMware.VISecret.psm1

@@ -0,0 +1,314 @@
+<#
+.SYNOPSIS
+This cmdlet downloads the dependencies and intializes the default settings of the VISecret module
+
+.PARAMETER Vault
+The vault to save the credentials to. The default value is "VMwareSecretStore"
+
+.DESCRIPTION
+This cmdlet downloads the dependecies and initializes the default settings of the VISecret module.
+It uses Microsoft.PowerShell.SecretStore as a default vault and sets it in no password mode, so that
+the credentials are encrypted, but the user is not prompted for a password. If you want to use a different
+vault or to use it with a password you should initialize those settings manually and not use this cmdlet.
+
+.EXAMPLE
+PS C:\> Initialize-VISecret
+
+Initializes the default settings of the VISecret module
+#>
+function Initialize-VISecret {
+    [CmdletBinding()]
+    param(
+        [string]$Vault = "VMwareSecretStore"
+    )
+
+    process {
+        Set-SecretStoreConfiguration -Scope CurrentUser -Authentication None -Interaction None -Confirm:$false 
+
+        Register-SecretVault -Name $Vault -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
+    }
+}
+
+<#
+.SYNOPSIS
+This cmdlet saves new credential in the secret vault or updates it if it already exists.
+
+.DESCRIPTION
+This cmdlet saves new credential in the secret vault or updates it if it already exists. 
+
+.PARAMETER Server
+The IP address or the hostname of the server to save the credential for
+
+.PARAMETER Password
+The password to be saved in the secret vault
+
+.PARAMETER SecureStringPassword
+The SecureString password to be saved in the secret vault
+
+.PARAMETER User
+The username for which to save the credential
+
+.PARAMETER Vault
+The vault to save the credential to. The default value is "VMwareSecretStore"
+
+.EXAMPLE
+PS C:\> New-VISecret -Server 10.10.10.10 -User administrator@vsphere.local -password pass
+
+Saves the password for the administrator@vsphere.local user on the 10.10.10.10 server in the secret vault
+
+#>
+function New-VISecret {
+    [CmdletBinding()]
+    [Alias("Set-VISecret")]
+    param (
+        [Parameter(Mandatory=$true)]
+        [string]$Server,
+        [Parameter(Mandatory=$true)]
+        [string]$User,
+        [string]$Password,
+        [securestring]$SecureStringPassword,
+        [string]$Vault
+    )
+    
+    begin {
+        if ([string]::IsNullOrWhiteSpace($password) -and (-not $secureStringPassword)) {
+            Throw "Either Password or SecureStringPassword parameter needs to be specified"
+        }
+
+        if (-not [string]::IsNullOrWhiteSpace($password) -and $secureStringPassword) {
+            Throw "Password and SecureStringPassword parameters cannot be both specified at the same time"
+        }
+    }
+    
+    process {
+        $params = @{
+            "Name" = "VISecret|"+$server+"|"+$User            
+        }
+         if ($password) {
+            $params += @{"Secret" = $password} 
+        } elseif ($secureStringPassword) {
+            $params += @{"SecureStringSecret" = $secureStringPassword}
+        } elseif ($Vault) {
+            $params += @{"Vault" = $Vault} 
+        }
+        Set-Secret @params
+    }
+}
+<#
+.SYNOPSIS
+Retrieves a credential from the secret store vault.
+
+.DESCRIPTION
+Retrieves a credential from the secret store vault.
+
+.PARAMETER Server
+The IP address or the hostname of the server to retrieve the credential for
+
+.PARAMETER User
+The username for which to retrieve the credential
+
+.PARAMETER AsPlainText
+Specifies that a credential should be returned as a String (in plain text) instead of a SecureString. 
+To ensure security, you should avoid using plaintext strings whenever possible.
+
+.PARAMETER Vault
+The vault to retrieve the credential from. The default value is "VMwareSecretStore"
+
+.EXAMPLE
+PS C:\> $securePassword = Get-VISecret -Server 10.10.10.10 -User administrator@vsphere.local
+
+Retrieves the password for the administrator@vsphere.local user on the 10.10.10.10 server from the secret vault
+#>
+function Get-VISecret {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory=$true)]
+        [string]$Server,
+        [Parameter(Mandatory=$true)]
+        [string]$User,
+        [switch]$AsPlainText,
+        [string]$Vault
+    )
+    
+    process {
+        $params = @{
+            "Name" = "VISecret|"+$server+"|"+$User            
+        }
+        if ($AsPlainText.IsPresent) {
+            $params += @{"AsPlainText" = $AsPlainText.ToBool()} 
+        } elseif ($Vault) {
+            $params += @{"Vault" = $Vault} 
+        }
+        Get-Secret @params        
+    }
+}
+
+<#
+.SYNOPSIS
+Removes a credential from the vault.
+
+.DESCRIPTION
+Removes a credential from the vault.
+
+.PARAMETER Server
+The IP address or the hostname of the server to remove the credential for
+
+.PARAMETER User
+The username for which to remove the credential
+
+.PARAMETER Vault
+The vault to remove the credential from. The default value is "VMwareSecretStore"
+
+.EXAMPLE
+PS C:\> Remove-VISecret -Server 10.10.10.10 -User administrator@vsphere.local
+
+Removes the password for the administrator@vsphere.local user on the 10.10.10.10 server from the vault
+#>
+function Remove-VISecret {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory=$true)]
+        [string]$Server,
+        [Parameter(Mandatory=$true)]
+        [string]$User,
+        [string]$Vault
+    )
+    
+    process {
+        $params = @{
+            "Name" = "VISecret|"+$server+"|"+$User            
+        }
+        if ($Vault) {
+            $params += @{"Vault" = $Vault} 
+        }
+        Remove-Secret @params
+    }
+}
+
+<#
+.SYNOPSIS
+This cmdlet establishes a connection to a vCenter Server system.
+
+.DESCRIPTION
+This cmdlet establishes a connection to a vCenter Server system. 
+If a credential object or username and password the cmdlet uses them to connect and if the
+-SaveCredential parameter is specified saves them in the vault. If only username
+is specified the cmdlet uses the server name and the user name to search for the password in the 
+vault. 
+
+.PARAMETER Server
+Specifies the IP address or the DNS name of the vSphere server to which you want to connect.
+
+.PARAMETER User
+Specifies the user name you want to use for authenticating with the server.
+
+.PARAMETER Password
+Specifies the password you want to use for authenticating with the server.
+
+.PARAMETER Credential
+Specifies a PSCredential object that contains credentials for authenticating with the server.
+
+.PARAMETER AllLinked
+Indicates whether you want to connect to vCenter Server in linked mode. If you specify $true 
+for the -AllLinked parameter and the server to which you want to connect is a part of a federation 
+vCenter Server, you'll be connected to all members of the linked vCenter Server. To use this 
+option, PowerCLI must be configured to work in multiple servers connection mode. To configure 
+PowerCLI to support multiple servers connection, specify Multiple for the DefaultVIServerMode 
+parameter of the Set-PowerCLIConfiguration cmdlet.
+
+.PARAMETER Force
+Suppresses all user interface prompts during the cmdlet execution.
+
+.PARAMETER NotDefault
+Indicates that you do not want to include the server to which you connect into the $defaultVIServers variable.
+
+.PARAMETER Port
+Specifies the port on the server you want to use for the connection.
+
+.PARAMETER Protocol
+Specifies the Internet protocol you want to use for the connection. It can be either http or https.
+
+.PARAMETER SaveCredentials
+Indicates that you want to save the specified credentials in the vault.
+
+.PARAMETER Vault
+The vault to save the credential to. The default value is "VMwareSecretStore"
+
+.EXAMPLE
+Connect-VIServer -Server 10.10.10.10 -User administrator@vsphere.local
+
+Connects to a vSphere server using the saved credential for the specified user
+
+.EXAMPLE
+Connect-VIServer -Server 10.10.10.10 -User administrator@vsphere.local -Password pass -SaveCredential
+
+Connects to a vSphere server using the specified username and password and saves them in the vault
+#>
+function Connect-VIServerWithSecret {
+    [CmdletBinding()]
+    param (
+        [Parameter(Mandatory=$true)]
+        [string]$Server,        
+        [string]$User,
+        [string]$Password,
+        [pscredential]$Credential,
+        [switch]$AllLinked,
+        [switch]$Force,
+        [switch]$NotDefault,
+        [int]$Port,
+        [string]$Protocol,
+        [switch]$SaveCredentials,
+        [string]$Vault
+    )
+
+    begin {
+        if ([string]::IsNullOrWhiteSpace($User) -and (-not $Credential)) {
+            if ($global:defaultUser) {
+                $User = $global:defaultUser
+            } else {
+                Throw "Either User or Credential parameters needs to be specified"
+            }
+        }
+
+        if ((-not [string]::IsNullOrWhiteSpace($User) -or -not [string]::IsNullOrWhiteSpace($Password)) -and $Credential) {
+            Throw "User/Password and Credential parameters cannot be both specified at the same time"
+        }
+    }
+
+    process {
+        $params = @{
+            "Server" = $Server
+            "AllLinked" = $AllLinked
+            "Force" = $Force
+            "NotDefault" = $NotDefault
+        }  
+        if ($Protocol) {
+            $params += @{"Protocol" = $Protocol}
+        }
+        if ($Port) {
+            $params += @{"Port" = $Port}
+        }
+        if ($User) {
+            if (-not $Password) {
+                if ($Vault) {
+                    $secret = Get-Secret -Name ("VISecret|"+$server+"|"+$User) -Vault $Vault -ErrorAction SilentlyContinue
+                } else {
+                    $secret = Get-Secret -Name ("VISecret|"+$server+"|"+$User) -ErrorAction SilentlyContinue
+                }
+                if (-not $secret) {
+                    Throw "No password has been found for this server and user in the password vault"
+                }
+                $Credential = New-Object System.Management.Automation.PSCredential ($User, $secret)
+            }
+            else {
+                $securePass = ConvertTo-SecureString -String $Password -AsPlainText
+                $Credential = New-Object System.Management.Automation.PSCredential ($User, $securePass)
+            }
+        }
+        $params += @{"Credential" = $Credential}
+        Connect-VIServer @params
+        if ($SaveCredentials) {
+            New-VISecret -Server $Server -User $User -SecureStringPassword $Credential.Password -Vault $Vault
+        }      
+    }
+}

Modules/VMCPFunctions/VMCPFunctions.psm1

@@ -1,5 +1,9 @@
-function Get-VMCPSettings {
-<#	
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+function Get-VMCPSettings {
+<#
 	.NOTES
 	===========================================================================
 	 Created on:   	10/27/2015 9:25 PM
@@ -11,7 +15,7 @@
      Modified on:  	10/11/2016
 	 Modified by:  	Erwan Quélin
      Twitter:       @erwanquelin
-     Github:        https://github.com/equelin    
+     Github:        https://github.com/equelin
 	===========================================================================
 	.DESCRIPTION
     This function will allow users to view the VMCP settings for their clusters
@@ -94,7 +98,7 @@
 }
 
 function Set-VMCPSettings {
-<#	
+<#
 	.NOTES
 	===========================================================================
 	 Created on:   	10/27/2015 9:25 PM
@@ -106,7 +110,7 @@ function Set-VMCPSettings {
      Modified on:  	10/11/2016
 	 Modified by:  	Erwan Quélin
      Twitter:       @erwanquelin
-     Github:        https://github.com/equelin    
+     Github:        https://github.com/equelin
 	===========================================================================
 	.DESCRIPTION
     This function will allow users to enable/disable VMCP and also allow
@@ -147,21 +151,21 @@ function Set-VMCPSettings {
     .EXAMPLE
     Set-VMCPSettings -cluster LAB-CL -enableVMCP:$True -VmStorageProtectionForPDL `
     restartAggressive -VmStorageProtectionForAPD restartAggressive `
-    -VmTerminateDelayForAPDSec 2000 -VmReactionOnAPDCleared reset 
+    -VmTerminateDelayForAPDSec 2000 -VmReactionOnAPDCleared reset
 
     This will enable VMCP and configure the Settings on cluster LAB-CL
 
     .EXAMPLE
     Set-VMCPSettings -cluster LAB-CL -enableVMCP:$False -VmStorageProtectionForPDL `
     disabled -VmStorageProtectionForAPD disabled `
-    -VmTerminateDelayForAPDSec 600 -VmReactionOnAPDCleared none 
+    -VmTerminateDelayForAPDSec 600 -VmReactionOnAPDCleared none
 
     This will disable VMCP and configure the Settings on cluster LAB-CL
 
     .EXAMPLE
     Set-VMCPSettings -enableVMCP:$False -VmStorageProtectionForPDL `
     disabled -VmStorageProtectionForAPD disabled `
-    -VmTerminateDelayForAPDSec 600 -VmReactionOnAPDCleared none 
+    -VmTerminateDelayForAPDSec 600 -VmReactionOnAPDCleared none
 
     This will disable VMCP and configure the Settings on all clusters available
 #>
@@ -173,7 +177,7 @@ function Set-VMCPSettings {
         ValueFromPipelineByPropertyName=$True,
         HelpMessage='What is the Cluster Name?')]
         $cluster,
-        
+
         [Parameter(Mandatory=$False,
         ValueFromPipeline=$False,
         HelpMessage='$True=Enabled $False=Disabled')]
@@ -184,24 +188,24 @@ function Set-VMCPSettings {
         HelpMessage='Actions that can be taken in response to a PDL event')]
         [ValidateSet("disabled","warning","restartAggressive")]
         [string]$VmStorageProtectionForPDL,
-        
+
         [Parameter(Mandatory=$False,
         ValueFromPipeline=$False,
         HelpMessage='Options available for an APD response')]
         [ValidateSet("disabled","restartConservative","restartAggressive","warning")]
         [string]$VmStorageProtectionForAPD,
-        
+
         [Parameter(Mandatory=$False,
         ValueFromPipeline=$False,
         HelpMessage='Value in seconds')]
         [Int]$VmTerminateDelayForAPDSec,
-        
+
         [Parameter(Mandatory=$False,
         ValueFromPipeline=$False,
         HelpMessage='This setting will instruct vSphere HA to take a certain action if an APD event is cleared')]
         [ValidateSet("reset","none")]
         [string]$VmReactionOnAPDCleared,
-        
+
         [Parameter(Mandatory=$False)]
         [VMware.VimAutomation.Types.VIServer[]]$Server = $global:DefaultVIServers
     )
@@ -232,14 +236,14 @@ function Set-VMCPSettings {
                 # Create the object we will configure
                 $settings = New-Object VMware.Vim.ClusterConfigSpecEx
                 $settings.dasConfig = New-Object VMware.Vim.ClusterDasConfigInfo
-                
-                # Based on $enableVMCP switch 
-                if ($enableVMCP -eq $false)  { 
+
+                # Based on $enableVMCP switch
+                if ($enableVMCP -eq $false)  {
                     $settings.dasConfig.vmComponentProtecting = "disabled"
-                } 
-                elseif ($enableVMCP -eq $true) { 
-                    $settings.dasConfig.vmComponentProtecting = "enabled" 
-                }  
+                }
+                elseif ($enableVMCP -eq $true) {
+                    $settings.dasConfig.vmComponentProtecting = "enabled"
+                }
 
                 #Create the VMCP object to work with
                 $settings.dasConfig.defaultVmSettings = New-Object VMware.Vim.ClusterDasVmSettings
@@ -295,7 +299,7 @@ function Set-VMCPSettings {
                 } else {
                     $settings.dasConfig.defaultVmSettings.vmComponentProtectionSettings.vmTerminateDelayForAPDSec = $ActualSettings.'APD Timeout (Seconds)'
                 }
-                
+
                 # Reaction On APD Cleared
                 If ($PSBoundParameters.ContainsKey('VmReactionOnAPDCleared')) {
                     $settings.dasConfig.defaultVmSettings.vmComponentProtectionSettings.vmReactionOnAPDCleared = "$VmReactionOnAPDCleared"

Modules/VMFSIncrease/VMFSIncrease.psm1

@@ -112,7 +112,7 @@ function Get-VmfsDatastoreIncrease
 					Datastore = $Datastore.Name
 					CanonicalName = $disk.CanonicalName
 					Model = "$($disk.Vendor.TrimEnd(' ')).$($disk.Model.TrimEnd(' ')).$($disk.Revision.TrimEnd(' '))"
-					DiskSizeGB = $partInfo[0].Layout.Total.BlockSize * $hdPartInfo[0].Layout.Total.Block / 1GB
+					DiskSizeGB = $partInfo[0].Layout.Total.BlockSize * $partInfo[0].Layout.Total.Block / 1GB
 					DiskBlocks = $partInfo[0].Layout.Total.Block
 					DiskBlockMB = $partInfo[0].Layout.Total.BlockSize/1MB
 					AvailableGB = [math]::Round($partMax - $partUsed, 2)
@@ -181,7 +181,7 @@ function New-VmfsDatastoreIncrease
 				{
 					$lun = $hScsiDisk | where{ $_.CanonicalName -eq $dsOpt.Spec.Extent.DiskName }
 					$partInfo = $hsSys.RetrieveDiskPartitionInfo($lun.DeviceName)
-					$partMax = ($vmfsExpOpt[0].Info.Layout.Partition | where{ $_.Type -eq 'VMFS' } | %{ ($_.End.Block - $_.Start.Block + 1) * $_.Start.BlockSize } |
+					$partMax = ($expOpt[0].Info.Layout.Partition | where{ $_.Type -eq 'VMFS' } | %{ ($_.End.Block - $_.Start.Block + 1) * $_.Start.BlockSize } |
 						Measure-Object -Sum | select -ExpandProperty Sum)/1GB
 					$partUsed = ($partInfo[0].Layout.Partition | where{ $_.Type -eq 'VMFS' } | %{ ($_.End.Block - $_.Start.Block + 1) * $_.Start.BlockSize } |
 						Measure-Object -Sum | select -ExpandProperty Sum)/1GB

Modules/VMToolsManagement/VMToolsManagement.psm1

@@ -1,4 +1,4 @@
-# Script Module : VMToolsManagement
+# Script Module : VMToolsManagement
 # Version       : 1.0
 
 # Copyright © 2017 VMware, Inc. All Rights Reserved.
@@ -37,10 +37,10 @@ New-VIProperty -Name ToolsBuildNumber -Object VirtualMachine -Value {
 Function Get-VMToolsInfo {
 <#
 .SYNOPSIS
-    This cmdlet retrieves the VMTools info of specified virtual machines.
+    This advanced function retrieves the VMTools info of specified virtual machines.
 
 .DESCRIPTION
-    This cmdlet retrieves the VMTools version and build number info of specified virtual machines.
+    This advanced function retrieves the VMTools version and build number info of specified virtual machines.
 
 .PARAMETER VM
     Specifies the virtual machines which you want to get the VMTools info of.
@@ -50,7 +50,7 @@ Function Get-VMToolsInfo {
     C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
     C:\PS> Get-VM -Server $VCServer | Get-VMToolsInfo
 
-    Retrieves VMTools info of all virtual machines which run in the $VCServer vCetner Server.
+    Retrieves VMTools info of all virtual machines which run in the $VCServer vCenter Server.
 
 .EXAMPLE
     C:\PS> Get-VM "*rhel*" | Get-VMToolsInfo
@@ -74,7 +74,7 @@ Function Get-VMToolsInfo {
     Retrieves VMTools info of virtual machines which run on the "MyESXiHostName" ESXi host.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
     The tools build number is not supported in VMTools before 10.2.0
 
 .NOTES
@@ -100,17 +100,17 @@ Function Get-VMToolsInfo {
     )
 
     Process {
-        Get-VM $VM | Select Name, @{Name="ToolsVersion"; Expression={$_.Guest.ToolsVersion}}, ToolsBuildNumber
+        Get-VM $VM | Select-Object Name, @{Name="ToolsVersion"; Expression={$_.Guest.ToolsVersion}}, ToolsBuildNumber
     }
 }
 
 Function Get-VMToolsInstallLastError {
 <#
 .SYNOPSIS
-    This cmdlet retrieves the error code of last VMTools installation.
+    This advanced function retrieves the error code of last VMTools installation.
 
 .DESCRIPTION
-    This cmdlet retrieves the error code of last VMTools installation on specified virtual machines.
+    This advanced function retrieves the error code of last VMTools installation on specified virtual machines.
 
 .PARAMETER VM
     Specifies the virtual machines which you want to get the error code of.
@@ -120,7 +120,7 @@ Function Get-VMToolsInstallLastError {
     C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
     C:\PS> Get-VM -Server $VCServer | Get-VMToolsInstallLastError
 
-    Retrieves the last VMTools installation error code of all virtual machines which run in the $VCServer vCetner Server.
+    Retrieves the last VMTools installation error code of all virtual machines which run in the $VCServer vCenter Server.
 
 .EXAMPLE
     C:\PS> Get-VM "*win*" | Get-VMToolsInstallLastError
@@ -144,7 +144,7 @@ Function Get-VMToolsInstallLastError {
     Retrieves the last VMTools installation error code of virtual machines which run on the "MyESXiHostName" ESXi host.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
 
 .NOTES
     Author                                    : Daoyuan Wang
@@ -171,7 +171,7 @@ Function Get-VMToolsInstallLastError {
     Process {
         $result = @()
         foreach ($_ in $VM) {
-            $errorCodeInfo = $_.ExtensionData.Config.ExtraConfig.GetEnumerator() | where {$_.Key -eq "guestinfo.toolsInstallErrCode"}
+            $errorCodeInfo = $_.ExtensionData.Config.ExtraConfig.GetEnumerator() | Where-Object {$_.Key -eq "guestinfo.toolsInstallErrCode"}
 
             $info = New-Object PSObject
             $info | Add-Member -type NoteProperty -name VmName -value $_.Name
@@ -186,10 +186,10 @@ Function Get-VMToolsInstallLastError {
 Function Get-VMToolsGuestInfo {
 <#
 .SYNOPSIS
-    This cmdlet retrieves the guest info of specified virtual machines.
+    This advanced function retrieves the guest info of specified virtual machines.
 
 .DESCRIPTION
-    This cmdlet retrieves the guest info such as HostName, IP, ToolsStatus, ToolsVersion,
+    This advanced function retrieves the guest info such as HostName, IP, ToolsStatus, ToolsVersion,
     ToolsInstallType and GuestFamily of specified virtual machines.
 
 .PARAMETER VM
@@ -200,7 +200,7 @@ Function Get-VMToolsGuestInfo {
     C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
     C:\PS> Get-VM -Server $VCServer | Get-VMToolsGuestInfo
 
-    Retrieves guest info of all virtual machines which run in the $VCServer vCetner Server.
+    Retrieves guest info of all virtual machines which run in the $VCServer vCenter Server.
 
 .EXAMPLE
     C:\PS> Get-VM "*win*" | Get-VMToolsGuestInfo
@@ -236,7 +236,7 @@ Function Get-VMToolsGuestInfo {
     Retrieves guest info of virtual machines which run on the "MyESXiHostName" ESXi host.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
 
 .NOTES
     Author                                    : Daoyuan Wang
@@ -261,7 +261,7 @@ Function Get-VMToolsGuestInfo {
     )
 
     Process {
-        Get-VM $VM | Select Name, @{Name="HostName"; Expression={$_.Guest.HostName}},
+        Get-VM $VM | Select-Object Name, @{Name="HostName"; Expression={$_.Guest.HostName}},
                             @{Name="IP"; Expression={$_.Guest.ExtensionData.IpAddress}},
                             @{Name="ToolsStatus"; Expression={$_.Guest.ExtensionData.ToolsStatus}},
                             @{Name="ToolsVersion"; Expression={$_.Guest.ToolsVersion}},
@@ -274,10 +274,10 @@ Function Get-VMToolsGuestInfo {
 Function Get-VMByToolsInfo {
 <#
 .SYNOPSIS
-    This cmdlet retrieves the virtual machines with specified VMTools info.
+    This advanced function retrieves the virtual machines with specified VMTools info.
 
 .DESCRIPTION
-    This cmdlet retrieves the virtual machines with specified VMTools version,
+    This advanced function retrieves the virtual machines with specified VMTools version,
     running status or version status.
 
 .PARAMETER VM
@@ -297,7 +297,7 @@ Function Get-VMByToolsInfo {
     C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
     C:\PS> Get-VM -Server $VCServer | Get-VMByToolsInfo
 
-    Retrieves the virtual machines with VMTools not running in vCetner Server $VCServer.
+    Retrieves the virtual machines with VMTools not running in vCenter Server $VCServer.
 
 .EXAMPLE
     C:\PS> Get-VM | Get-VMByToolsInfo -ToolsRunningStatus guestToolsNotRunning
@@ -328,7 +328,7 @@ Function Get-VMByToolsInfo {
     Retrieves the virtual machines with VMTools that need to upgrade on the "MyESXiHostName" ESXi host.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
 
 .NOTES
     Author                                    : Daoyuan Wang
@@ -361,9 +361,9 @@ Function Get-VMByToolsInfo {
         [String] $ToolsRunningStatus,
 
         [Parameter(Mandatory=$false)]
-        [ValidateSet("guestToolsNotInstalled",
-                    "guestToolsNeedUpgrade",
-                    "guestToolsCurrent",
+        [ValidateSet("guestToolsNotInstalled",
+                    "guestToolsNeedUpgrade",
+                    "guestToolsCurrent",
                     "guestToolsUnmanaged")]
         [String] $ToolsVersionStatus
     )
@@ -376,65 +376,60 @@ Function Get-VMByToolsInfo {
         }
 
         if ($ToolsVersion) {
-            $vmList = $vmList | Where {$_.Guest.ToolsVersion -like $ToolsVersion}
+            $vmList = $vmList | Where-Object {$_.Guest.ToolsVersion -like $ToolsVersion}
         }
 
         if ($ToolsRunningStatus) {
-            $vmList = $vmList | Where {$_.Guest.ExtensionData.ToolsRunningStatus -eq $ToolsRunningStatus}
+            $vmList = $vmList | Where-Object {$_.Guest.ExtensionData.ToolsRunningStatus -eq $ToolsRunningStatus}
         }
 
         if ($ToolsVersionStatus) {
-            $vmList = $vmList | Where {$_.Guest.ExtensionData.ToolsVersionStatus -eq $ToolsVersionStatus}
+            $vmList = $vmList | Where-Object {$_.Guest.ExtensionData.ToolsVersionStatus -eq $ToolsVersionStatus}
         }
 
         $vmList
     }
 }
 
-Function Set-VMToolsUpgradePolicy {
+Function Get-VMToolsUpgradePolicy {
 <#
 .SYNOPSIS
-    This cmdlet sets the VMTool's upgrade policy to "upgradeAtPowerCycle".
+    This advanced function retrieves the VMTools upgrade policy info of specified virtual machines.
 
 .DESCRIPTION
-    This cmdlet sets the VMTool's upgrade policy to "upgradeAtPowerCycle" of specified virtual machines.
+    This advanced function retrieves the VMTools upgrade policy info of specified virtual machines.
 
 .PARAMETER VM
-    Specifies the virtual machines which you want to set the VMTool's upgrade policy of.
+    Specifies the virtual machines which you want to query VMTools status of.
 
 .EXAMPLE
-    C:\PS> Import-Module .\VMToolsManagement.psm1
-    C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
-    C:\PS> Get-VM -Server $VCServer | Set-VMToolsUpgradePolicy
-
-    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of all virtual machines in the $VCServer vCetner Server.
+    C:\PS> Get-VM "*rhel*" | Get-VMToolsUpgradePolicy
+    Name                   VMToolsUpgradePolicy
+    ------                 ----------------------
+    111394-RHEL-6.8-0      manual
+    111394-RHEL-6.8-1      manual
+    111393-RHEL-Server-7.2 upgradeAtPowerCycle
+    Retrieves VMTools upgrade policy info of virtual machines with name containing "rhel".
 
 .EXAMPLE
-    C:\PS> Get-VM "*win*" | Set-VMToolsUpgradePolicy
-
-    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of virtual machines with name containing "win".
+    C:\PS> Get-VM -Location "MyClusterName" | Get-VMToolsUpgradePolicy
+    Retrieves VMTools upgrade policy info from virtual machines which run in the "MyClusterName" cluster.
 
 .EXAMPLE
-    C:\PS> Get-VM -Location "MyClusterName" | Set-VMToolsUpgradePolicy
-
-    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of virtual machines in the "MyClusterName" cluster.
-
-.EXAMPLE
-    C:\PS> Get-VMHost "MyESXiHostName" | Get-VM | Set-VMToolsUpgradePolicy
-
-    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of virtual machines on the "MyESXiHostName" ESXi host.
+    C:\PS> Get-VMHost "MyESXiHostName" | Get-VM | Get-VMToolsUpgradePolicy
+    Retrieves VMTools upgrade policyinfo of virtual machines which run on the "MyESXiHostName" ESXi host.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
 
 .NOTES
-    Author                                    : Daoyuan Wang
-    Author email                              : daoyuanw@vmware.com
+    Author                                    : Kyle Ruddy
+    Author email                              : kmruddy@gmail.com
     Version                                   : 1.0
     ==========Tested Against Environment==========
-    VMware vSphere Hypervisor(ESXi) Version   : 6.5 (build 4564106)
-    VMware vCenter Server Version             : 6.5 (build 4602587)
-    PowerCLI Version                          : PowerCLI 6.5 (build 4624819)
+    VMware vSphere Hypervisor(ESXi) Version   : 6.5 (build 7388607)
+    VMware vCenter Server Version             : 6.5 (build 7312210)
+    PowerCLI Version                          : PowerCLI 6.5 (build 7155375)
     PowerShell Version                        : 5.1
 #>
 
@@ -448,8 +443,81 @@ Function Set-VMToolsUpgradePolicy {
         [ValidateNotNullOrEmpty()]
         [VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine[]] $VM
     )
+
+    Process {
+        
+        Get-VM $VM | Select-Object Name, @{Name="VMToolsUpgradePolicy"; Expression={$_.ExtensionData.Config.Tools.ToolsUpgradePolicy}}
+
+    }
+
+}
+
+Function Set-VMToolsUpgradePolicy {
+<#
+.SYNOPSIS
+    This advanced function sets the VMTool's upgrade policy to either "manual" or "upgradeAtPowerCycle".
+
+.DESCRIPTION
+    This advanced function sets the VMTool's upgrade policy to either "manual" or "upgradeAtPowerCycle" of specified virtual machines.
+
+.PARAMETER VM
+    Specifies the virtual machines which you want to set the VMTool's upgrade policy of.
+
+.EXAMPLE
+    C:\PS> Import-Module .\VMToolsManagement.psm1
+    C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
+    C:\PS> Get-VM -Server $VCServer | Set-VMToolsUpgradePolicy -UpgradePolicy manual
+
+    Sets VMTool's upgrade policy to "manual" of all virtual machines in the $VCServer vCenter Server.
+
+.EXAMPLE
+    C:\PS> Get-VM "*win*" | Set-VMToolsUpgradePolicy -UpgradePolicy upgradeAtPowerCycle
+
+    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of virtual machines with name containing "win".
+
+.EXAMPLE
+    C:\PS> Get-VM -Location "MyClusterName" | Set-VMToolsUpgradePolicy -UpgradePolicy upgradeAtPowerCycle
+
+    Sets VMTool's upgrade policy to "upgradeAtPowerCycle" of virtual machines in the "MyClusterName" cluster.
+
+.EXAMPLE
+    C:\PS> Get-VMHost "MyESXiHostName" | Get-VM | Set-VMToolsUpgradePolicy -UpgradePolicy manual
+
+    Sets VMTool's upgrade policy to "manual" of virtual machines on the "MyESXiHostName" ESXi host.
+
+.NOTES
+    This advanced function assumes that you are connected to at least one vCenter Server system.
+
+.NOTES
+    Author                                    : Daoyuan Wang
+    Author email                              : daoyuanw@vmware.com
+    Version                                   : 1.1
+    Update Author                             : Kyle Ruddy
+    Update email                              : kmruddy@gmail.com
+    ==========Tested Against Environment==========
+    VMware vSphere Hypervisor(ESXi) Version   : 6.5 (build 4564106)(build 7388607)
+    VMware vCenter Server Version             : 6.5 (build 4602587)(build 7312210)
+    PowerCLI Version                          : PowerCLI 6.5 (build 4624819)(build 7155375)
+    PowerShell Version                        : 5.1
+#>
+
+    [CmdletBinding(SupportsShouldProcess)]
+
+    Param (
+        [Parameter(Mandatory=$true,
+                    ValueFromPipeLine = $true,
+                    ValueFromPipelinebyPropertyName=$True,
+                    Position = 0)]
+        [ValidateNotNullOrEmpty()]
+        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine[]] $VM,
+
+        [Parameter(Mandatory=$false,
+                    Position = 1)]
+        [ValidateSet("upgradeAtPowerCycle",
+                    "manual")]
+        [String] $UpgradePolicy
+    )
     Begin {
-        $UpgradePolicy = "upgradeAtPowerCycle"
         $vmConfigSpec = New-Object VMware.Vim.VirtualMachineConfigSpec
         $vmConfigSpec.Tools = New-Object VMware.Vim.ToolsConfigInfo
         $vmConfigSpec.Tools.ToolsUpgradePolicy = $UpgradePolicy
@@ -463,6 +531,7 @@ Function Set-VMToolsUpgradePolicy {
             if ($vmView.Config.Tools.ToolsUpgradePolicy -ne $UpgradePolicy) {
                 Write-Verbose "Applying 'upgradeAtPowerCycle' setting to $($_.Name)..."
                 $vmView.ReconfigVM($vmConfigSpec)
+                Get-VMToolsUpgradePolicy -VM $_
             }
         }
     }
@@ -471,10 +540,10 @@ Function Set-VMToolsUpgradePolicy {
 Function Invoke-VMToolsListProcessInVM {
 <#
 .Synopsis
-    This cmdlet lists the processes in the virtual machine.
+    This advanced function lists the processes in the virtual machine.
 
 .Description
-    This cmdlet lists the running processes in the virtual machine.
+    This advanced function lists the running processes in the virtual machine.
 
 .PARAMETER VM
     Specifies the virtual machine which you want to list the processes of.
@@ -503,7 +572,7 @@ Function Invoke-VMToolsListProcessInVM {
     List the processes in the "MyVMName" VM.
 
 .NOTES
-    This cmdlet lists processes in the guest OS of virtual machine.
+    This advanced function lists processes in the guest OS of virtual machine.
     A VMTools should already be running in the guest OS.
 
 .NOTES
@@ -559,10 +628,10 @@ Function Invoke-VMToolsListProcessInVM {
 Function Update-VMToolsImageLocation {
 <#
 .Synopsis
-    This cmdlet updates the link /productLocker in ESXi host.
+    This advanced function updates the link /productLocker in ESXi host.
 
 .Description
-    This cmdlet updates the link /productLocker in ESXi host directly to avoid host reboot.
+    This advanced function updates the link /productLocker in ESXi host directly to avoid host reboot.
 
 .Parameter VMHost
     Specifies the ESXi host on which you want to update the /productLocker link.
@@ -574,7 +643,7 @@ Function Update-VMToolsImageLocation {
     Specifies the password you want to use for authenticating with the ESXi host.
 
 .Parameter ImageLocation
-    Specifies the new image location where you want /producterLocker to link.
+    Specifies the new image location Where-Object you want /producterLocker to link.
 
 .Example
     C:\PS> Import-Module .\VMToolsManagement.psm1
@@ -586,9 +655,9 @@ Function Update-VMToolsImageLocation {
     Update the link /producterLocker on $SampleHost to point to '/locker/packages/6.5.0/'.
 
 .NOTES
-    This cmdlet connects to ESXi host to execute shell command directly.
+    This advanced function connects to ESXi host to execute shell command directly.
     Make sure the SSH service on ESXi host is enabled, and a SSH library(Posh-SSH or SSH-Sessions etc.)
-    for powershell is already installed on client where you call This cmdlet.
+    for powershell is already installed on client Where-Object you call this advanced function.
     You can instal Posh-SSH by executing:
         iex (New-Object Net.WebClient).DownloadString("https://gist.github.com/darkoperator/6152630/raw/c67de4f7cd780ba367cccbc2593f38d18ce6df89/instposhsshdev")
     For SSH-Sessions installation and usage, please refer to
@@ -628,7 +697,7 @@ Function Update-VMToolsImageLocation {
 
     Process {
         if (-not (Get-Command New-SSHSession)) {
-            Throw "This cmdlet depends on SSH library. Please ensure a SSH library is already installed!"
+            Throw "This advanced function depends on SSH library. Please ensure a SSH library is already installed!"
         }
 
         $password = new-object System.Security.SecureString
@@ -656,18 +725,21 @@ Function Update-VMToolsImageLocation {
     }
 }
 
-Function Update-VMToolsConfInVM {
+Function Set-VMToolsConfInVM {
 <#
 .Synopsis
-    This cmdlet updates the tools.conf content in guest OS.
+    This advanced function sets the tools.conf content in guest OS.
 
 .Description
-    This cmdlet copies the tools.conf in gueset OS of virtual machine to localhost,
-    then updates it locally by setting "vmtoolsd.level = info" and copies it back to the guest OS.
+    This advanced function copies the tools.conf in gueset OS of virtual machine to localhost,
+    then sets it locally by setting "vmtoolsd.level" to a valid level and copies it back to the guest OS.
 
 .PARAMETER VM
     Specifies the virtual machine to update.
 
+.PARAMETER LogLevel
+    Specifies the desired log level to log.
+
 .Parameter GuestUser
     Specifies the user name you want to use for authenticating with the guest OS.
 
@@ -684,16 +756,18 @@ Function Update-VMToolsConfInVM {
     Updates the tools.conf in $SampleVM, changes the vmtoolsd log level to info ("vmtoolsd.level = info") for example.
 
 .NOTES
-    This cmdlet updates the tools.conf in guest OS. A VMTools should already be running in the guest OS.
+    This advanced function updates the tools.conf in guest OS. A VMTools should already be running in the guest OS.
 
 .NOTES
     Author                                    : Daoyuan Wang
     Author email                              : daoyuanw@vmware.com
-    Version                                   : 1.0
+    Version                                   : 1.1
+    Update Author                             : Kyle Ruddy
+    Update email                              : kmruddy@gmail.com
     ==========Tested Against Environment==========
-    VMware vSphere Hypervisor(ESXi) Version   : 6.5 (build 4564106)
-    VMware vCenter Server Version             : 6.5 (build 4602587)
-    PowerCLI Version                          : PowerCLI 6.5 (build 4624819)
+    VMware vSphere Hypervisor(ESXi) Version   : 6.5 (build 4564106)(build 7388607)
+    VMware vCenter Server Version             : 6.5 (build 4602587)(build 7312210)
+    PowerCLI Version                          : PowerCLI 6.5 (build 4624819)(build 7155375)
     PowerShell Version                        : 5.1
 #>
 
@@ -707,6 +781,17 @@ Function Update-VMToolsConfInVM {
         [ValidateNotNullOrEmpty()]
         [VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine] $VM,
 
+        [Parameter(Mandatory=$true,
+                    Position = 1)]
+        [ValidateSet("none",
+                    "critical",
+                    "error",
+                    "warning",
+                    "message",
+                    "info",
+                    "debug")]
+        [String] $LogLevel,
+
         [Parameter(Mandatory=$true)]
         [String] $GuestUser,
 
@@ -756,7 +841,7 @@ Function Update-VMToolsConfInVM {
         # Updates tools.conf by setting vmtoolsd.level = info, just for example.
         #############################################################################
         $confContent = Get-Content $localToolsConfFile
-        $updatedContent = "vmtoolsd.level = info"
+        $updatedContent = "vmtoolsd.level = $LogLevel"
 
         Write-Verbose "Editing tools.conf (set 'vmtoolsd.level = info' for example)..."
         if ($confContent -match "vmtoolsd\.level") {
@@ -775,19 +860,23 @@ Function Update-VMToolsConfInVM {
                     -GuestUser $GuestUser -GuestPassword $GuestPassword -Force -ErrorAction:Stop
         } catch {
             Write-Error "Failed to update tools.conf of $VM"
+            Write-Verbose "Removing the local tools configuration file"
+            Remove-Item $localToolsConfFile
             return
         }
         Write-Host "The tools.conf updated in $VM successfully." -ForegroundColor Green
+        Write-Verbose "Removing the local tools configuration file"
+        Remove-Item $localToolsConfFile 
     }
 }
 
 Function Invoke-VMToolsVIBInstall {
 <#
 .SYNOPSIS
-    This cmdlet installs VMTool VIB in ESXi hosts.
+    This advanced function installs VMTool VIB in ESXi hosts.
 
 .DESCRIPTION
-    This cmdlet installs VMTool VIB in specified ESXi hosts.
+    This advanced function installs VMTool VIB in specified ESXi hosts.
 
 .PARAMETER VMHost
     Specifies the ESXi hosts which you want to install VMTool VIB in.
@@ -816,7 +905,7 @@ Function Invoke-VMToolsVIBInstall {
     Installs VMTool VIB in ESXi host of the "MyClusterName" cluster.
 
 .NOTES
-    This cmdlet assumes that you are connected to at least one vCenter Server system.
+    This advanced function assumes that you are connected to at least one vCenter Server system.
 
 .NOTES
     Author                                    : Daoyuan Wang
@@ -846,7 +935,7 @@ Function Invoke-VMToolsVIBInstall {
         foreach ($_ in $VMHost) {
             $esxcli = Get-EsxCLI -VMHost $_ -V2
 
-            $result = $esxcli.software.vib.list.Invoke() | where {$_.name -match 'tools'}
+            $result = $esxcli.software.vib.list.Invoke() | Where-Object {$_.name -match 'tools'}
             Write-Verbose "Existing tools VIB on $_ before installing: $($result.Name)_$($result.Version)"
 
             # Install VIBs
@@ -861,7 +950,7 @@ Function Invoke-VMToolsVIBInstall {
                 Write-Error "Failed to install VMTools VIB package!"
             } else {
                 Write-Verbose $result.Message
-                $result = $esxcli.software.vib.list.Invoke() | where {$_.name -match 'tools'}
+                $result = $esxcli.software.vib.list.Invoke() | Where-Object {$_.name -match 'tools'}
                 Write-Verbose "Tools VIB on $_ after installing: $($result.Name)_$($result.Version)"
                 Write-Host "VMTools VIB package installed on $_ successfully." -ForegroundColor Green
             }
@@ -872,10 +961,10 @@ Function Invoke-VMToolsVIBInstall {
 Function Invoke-VMToolsUpgradeInVMs {
 <#
 .SYNOPSIS
-    This cmdlet upgrades VMTools to the version bundled by ESXi host.
+    This advanced function upgrades VMTools to the version bundled by ESXi host.
 
 .DESCRIPTION
-    This cmdlet upgrades VMTools of specified virtual machines to the version
+    This advanced function upgrades VMTools of specified virtual machines to the version
     bundled by ESXi host. You can also specify the number of virtual machines
     to upgrade in parallel.
 
@@ -896,7 +985,7 @@ Function Invoke-VMToolsUpgradeInVMs {
     C:\PS> $VCServer = Connect-VIServer -Server <vCenter Server IP> -User <vCenter User> -Password <vCenter Password>
     C:\PS> Get-VM -Server $VCServer | Invoke-VMToolsUpgradeInVMs -MaxParallelUpgrades 5
 
-    Upgrades VMTools of all virtual machines in the $VCServer vCetner Server, 5 at a time in parallel.
+    Upgrades VMTools of all virtual machines in the $VCServer vCenter Server, 5 at a time in parallel.
 
 .EXAMPLE
     C:\PS> Get-VM | Invoke-VMToolsUpgradeInVMs -GuestOSType windows -MaxParallelUpgrades 1 | ft -Autosize
@@ -929,7 +1018,7 @@ Function Invoke-VMToolsUpgradeInVMs {
     Upgrades VMTools of virtual machines on the "MyESXiHostName" ESXi host, 5 at a time.
 
 .NOTES
-    This cmdlet assumes an old VMTools is already running in the virtual machine.
+    This advanced function assumes an old VMTools is already running in the virtual machine.
 
 .NOTES
     Author                                    : Daoyuan Wang
@@ -1026,7 +1115,7 @@ Function Invoke-VMToolsUpgradeInVMs {
                 # Load PowerCLI module and connect to VCServer, as child thread environment is independent with parent
                 if(-not $global:DefaultVIServer) {
                     $moduleName = "vmware.vimautomation.core"
-                    if(-not (Get-Module | Where {$_.name -eq $moduleName})) {
+                    if(-not (Get-Module | Where-Object {$_.name -eq $moduleName})) {
                         try {
                             Import-Module $moduleName -ErrorAction SilentlyContinue | Out-Null
                         }
@@ -1130,7 +1219,7 @@ Function Invoke-VMToolsUpgradeInVMs {
 
     End {
         #Verify all threads completed
-        while (($jobs | Where {$_.Handle.iscompleted -ne ‘Completed’}).Count -gt 0) {
+        while (($jobs | Where-Object {$_.Handle.iscompleted -ne "Completed"}).Count -gt 0) {
             Start-Sleep -Seconds 5
         }
 
@@ -1146,4 +1235,4 @@ Function Invoke-VMToolsUpgradeInVMs {
     }
 }
 
-Export-ModuleMember *-*
+Export-ModuleMember *-*

Modules/VMware-vCD-Module/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Markus Kraus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Modules/VMware-vCD-Module/VMware-vCD-Module.psd1

@@ -1,5 +1,5 @@
 #
-# Modulmanifest für das Modul "PSGet_VMware-vCD-Module"
+# Modulmanifest f<EFBFBD>r das Modul "PSGet_VMware-vCD-Module"
 #
 # Generiert von: Markus
 #
@@ -8,52 +8,52 @@
 
 @{
 
-# Die diesem Manifest zugeordnete Skript- oder Binärmoduldatei.
+# Die diesem Manifest zugeordnete Skript- oder Bin<EFBFBD>rmoduldatei.
 # RootModule = ''
 
 # Die Versionsnummer dieses Moduls
-ModuleVersion = '1.0.0'
+ModuleVersion = '1.3.0'
 
 # ID zur eindeutigen Kennzeichnung dieses Moduls
 GUID = '1ef8a2de-ca22-4c88-8cdb-e00f35007d2a'
 
 # Autor dieses Moduls
-Author = 'Markus'
+Author = 'Markus Kraus'
 
 # Unternehmen oder Hersteller dieses Moduls
 CompanyName = 'mycloudrevolution.com'
 
-# Urheberrechtserklärung für dieses Modul
+# Urheberrechtserkl<EFBFBD>rung f<EFBFBD>r dieses Modul
 Copyright = '(c) 2017 Markus. Alle Rechte vorbehalten.'
 
 # Beschreibung der von diesem Modul bereitgestellten Funktionen
-# Description = ''
+Description = 'This a POwerShell Module based on VMware PowerCLI vCloud Director Module to extend its function'
 
-# Die für dieses Modul mindestens erforderliche Version des Windows PowerShell-Moduls
+# Die f<EFBFBD>r dieses Modul mindestens erforderliche Version des Windows PowerShell-Moduls
 # PowerShellVersion = ''
 
-# Der Name des für dieses Modul erforderlichen Windows PowerShell-Hosts
+# Der Name des f<EFBFBD>r dieses Modul erforderlichen Windows PowerShell-Hosts
 # PowerShellHostName = ''
 
-# Die für dieses Modul mindestens erforderliche Version des Windows PowerShell-Hosts
+# Die f<EFBFBD>r dieses Modul mindestens erforderliche Version des Windows PowerShell-Hosts
 # PowerShellHostVersion = ''
 
-# Die für dieses Modul mindestens erforderliche Microsoft .NET Framework-Version
+# Die f<EFBFBD>r dieses Modul mindestens erforderliche Microsoft .NET Framework-Version
 # DotNetFrameworkVersion = ''
 
-# Die für dieses Modul mindestens erforderliche Version der CLR (Common Language Runtime)
+# Die f<EFBFBD>r dieses Modul mindestens erforderliche Version der CLR (Common Language Runtime)
 # CLRVersion = ''
 
-# Die für dieses Modul erforderliche Prozessorarchitektur ("Keine", "X86", "Amd64").
+# Die f<EFBFBD>r dieses Modul erforderliche Prozessorarchitektur ("Keine", "X86", "Amd64").
 # ProcessorArchitecture = ''
 
-# Die Module, die vor dem Importieren dieses Moduls in die globale Umgebung geladen werden müssen
-# RequiredModules = @()
+# Die Module, die vor dem Importieren dieses Moduls in die globale Umgebung geladen werden m<EFBFBD>ssen
+RequiredModules = @('VMware.VimAutomation.Cloud')
 
-# Die Assemblys, die vor dem Importieren dieses Moduls geladen werden müssen
+# Die Assemblys, die vor dem Importieren dieses Moduls geladen werden m<EFBFBD>ssen
 # RequiredAssemblies = @()
 
-# Die Skriptdateien (PS1-Dateien), die vor dem Importieren dieses Moduls in der Umgebung des Aufrufers ausgeführt werden.
+# Die Skriptdateien (PS1-Dateien), die vor dem Importieren dieses Moduls in der Umgebung des Aufrufers ausgef<EFBFBD>hrt werden.
 # ScriptsToProcess = @()
 
 # Die Typdateien (.ps1xml), die beim Importieren dieses Moduls geladen werden sollen
@@ -63,14 +63,16 @@ Copyright = '(c) 2017 Markus. Alle Rechte vorbehalten.'
 # FormatsToProcess = @()
 
 # Die Module, die als geschachtelte Module des in "RootModule/ModuleToProcess" angegebenen Moduls importiert werden sollen.
-NestedModules = @('functions\Invoke-MyOnBoarding.psm1', 
+NestedModules = @('functions\Invoke-MyOnBoarding.psm1',
                'functions\New-MyEdgeGateway.psm1',
-               'functions\New-MyOrg.psm1', 
-               'functions\New-MyOrgAdmin.psm1', 
-               'functions\New-MyOrgVdc.psm1')
+               'functions\New-MyOrg.psm1',
+               'functions\New-MyOrgAdmin.psm1',
+               'functions\New-MyOrgVdc.psm1',
+               'functions\New-MyOrgNetwork.psm1'
+               )
 
 # Aus diesem Modul zu exportierende Funktionen
-FunctionsToExport = 'Invoke-MyOnBoarding', 'New-MyEdgeGateway', 'New-MyOrg', 'New-MyOrgAdmin', 'New-MyOrgVdc'
+FunctionsToExport = 'Invoke-MyOnBoarding', 'New-MyEdgeGateway', 'New-MyOrg', 'New-MyOrgAdmin', 'New-MyOrgVdc', 'New-MyOrgNetwork'
 
 # Aus diesem Modul zu exportierende Cmdlets
 CmdletsToExport = '*'
@@ -90,28 +92,28 @@ AliasesToExport = '*'
 # Liste aller Dateien in diesem Modulpaket
 # FileList = @()
 
-# Die privaten Daten, die an das in "RootModule/ModuleToProcess" angegebene Modul übergeben werden sollen. Diese können auch eine PSData-Hashtabelle mit zusätzlichen von PowerShell verwendeten Modulmetadaten enthalten.
+# Die privaten Daten, die an das in "RootModule/ModuleToProcess" angegebene Modul <EFBFBD>bergeben werden sollen. Diese k<EFBFBD>nnen auch eine PSData-Hashtabelle mit zus<EFBFBD>tzlichen von PowerShell verwendeten Modulmetadaten enthalten.
 PrivateData = @{
 
     PSData = @{
 
         # Tags applied to this module. These help with module discovery in online galleries.
-        # Tags = @()
+        Tags = @('VMware', 'vCloud', 'PowerCLI', 'vCloudDirector', 'Automation', 'EdgeGateway', 'OrgNetwork')
 
         # A URL to the license for this module.
-        # LicenseUri = ''
+        LicenseUri = 'https://github.com/mycloudrevolution/VMware-vCD-Module/blob/master/LICENSE'
 
         # A URL to the main website for this project.
-        # ProjectUri = ''
+        ProjectUri = 'https://github.com/mycloudrevolution/VMware-vCD-Module'
 
         # A URL to an icon representing this module.
-        # IconUri = ''
+        IconUri = 'https://github.com/mycloudrevolution/VMware-vCD-Module/blob/master/media/vCD_Small.png'
 
         # ReleaseNotes of this module
         # ReleaseNotes = ''
 
         # External dependent modules of this module
-        # ExternalModuleDependencies = ''
+        ExternalModuleDependencies = 'VMware.VimAutomation.Cloud'
 
     } # End of PSData hashtable
 
@@ -120,7 +122,7 @@ PrivateData = @{
 # HelpInfo-URI dieses Moduls
 # HelpInfoURI = ''
 
-# Standardpräfix für Befehle, die aus diesem Modul exportiert werden. Das Standardpräfix kann mit "Import-Module -Prefix" überschrieben werden.
+# Standardpr<EFBFBD>fix f<EFBFBD>r Befehle, die aus diesem Modul exportiert werden. Das Standardpr<EFBFBD>fix kann mit "Import-Module -Prefix" <EFBFBD>berschrieben werden.
 # DefaultCommandPrefix = ''
 
 }

Modules/VMware-vCD-Module/functions/Invoke-MyOnBoarding.psm1

@@ -1,6 +1,4 @@
-#Requires -Version 4
-#Requires -Modules VMware.VimAutomation.Cloud, @{ModuleName="VMware.VimAutomation.Cloud";ModuleVersion="6.3.0.0"}
-Function Invoke-MyOnBoarding {
+Function Invoke-MyOnBoarding {
 <#
 .SYNOPSIS
     Creates all vCD Objecst for a new IAAS Customer
@@ -158,18 +156,22 @@ Function Invoke-MyOnBoarding {
 
             if ($Configs.OrgVdc.ExternalNetwork -and $Configs.OrgVdc.EdgeGateway -like "Yes"){
                 Write-Host "Edge Gateway for Org VDC '$($Configs.OrgVdc.Name)' Requested!"
-                $Trash = New-MyOrgVdc -Name $Configs.OrgVdc.Name -CPULimit $CPULimit -MEMLimit $MEMLimit -StorageLimit $StorageLimit -Networkpool $Configs.OrgVdc.NetworkPool `
+                $Trash = New-MyOrgVdc -Name $Configs.OrgVdc.Name -CPULimit $CPULimit -MEMLimit $MEMLimit -StorageLimit $StorageLimit -Networkpool $Configs.OrgVdc.NetworkPool `
+                            -StorageProfile $Configs.OrgVdc.StorageProfile -ProviderVDC $Configs.OrgVdc.ProviderVDC -Org $Configs.Org.Name -Enabled:$Enabled
 
                 $EdgeName = $Configs.Org.Name + "-ESG01"
-                $EdgeName = $Configs.Org.Name + "-ESG01"
+                $Trash = New-MyEdgeGateway -Name $EdgeName -OrgVDCName $Configs.OrgVdc.Name -Orgname $Configs.Org.Name -ExternalNetwork $Configs.OrgVdc.ExternalNetwork `
+                            -IPAddress $Configs.OrgVdc.IPAddress -SubnetMask $Configs.OrgVdc.SubnetMask -Gateway  $Configs.OrgVdc.Gateway -IPRangeStart $Configs.OrgVdc.IPRangeStart -IPRangeEnd $Configs.OrgVdc.IPRangeEnd
                 }
                 elseif ($Configs.OrgVdc.ExternalNetwork -and $Configs.OrgVdc.EdgeGateway -like "No"){
                     Write-Host "External Network for Org VDC '$($Configs.OrgVdc.Name)' Requested!"
-                elseif ($Configs.OrgVdc.ExternalNetwork -and $Configs.OrgVdc.EdgeGateway -like "No"){
+                    $Trash = New-MyOrgVdc -Name $Configs.OrgVdc.Name -CPULimit $CPULimit -MEMLimit $MEMLimit -StorageLimit $StorageLimit -Networkpool $Configs.OrgVdc.NetworkPool `
+                                -StorageProfile $Configs.OrgVdc.StorageProfile -ProviderVDC $Configs.OrgVdc.ProviderVDC -ExternalNetwork $Configs.OrgVdc.ExternalNetwork  -Org $Configs.Org.Name -Enabled:$Enabled
                     }
                     else {
                         Write-Host "No external Connection for Org VDC '$($Configs.OrgVdc.Name)' Requested!"
-                    }
+                        $Trash = New-PecOrgVdc -Name $Configs.OrgVdc.Name -CPULimit $CPULimit -MEMLimit $MEMLimit -StorageLimit $StorageLimit -Networkpool $ProVdcNetworkPool.Name `
+                                    -StorageProfile $Configs.OrgVdc.StorageProfile -ProviderVDC $Configs.OrgVdc.ProviderVDC -Org $Configs.Org.Name -Enabled:$Enabled
                 }
             Write-Host  "$(Get-Date -Format "yyyy-MM-dd HH:mm:ss") Creating new OrgVdc OK" -ForegroundColor Green
             Get-OrgVdc -Org $Configs.Org.Name -Name $Configs.OrgVdc.Name  | Select-Object Name, Enabled, CpuAllocationGhz, MemoryLimitGB, StorageLimitGB, AllocationModel, ThinProvisioned, UseFastProvisioning, `

Modules/VMware-vCD-Module/functions/New-MyEdgeGateway.psm1

@@ -1,6 +1,4 @@
-#Requires -Version 4
-#Requires -Modules VMware.VimAutomation.Cloud, @{ModuleName="VMware.VimAutomation.Cloud";ModuleVersion="6.3.0.0"}
-Function New-MyEdgeGateway {
+Function New-MyEdgeGateway {
 <#
 .SYNOPSIS
     Creates a new Edge Gateway with Default Parameters
@@ -9,7 +7,6 @@ Function New-MyEdgeGateway {
     Creates a new Edge Gateway with Default Parameters
 
     Default Parameters are:
-    * Size
     * HA State
     * DNS Relay
 
@@ -17,14 +14,14 @@ Function New-MyEdgeGateway {
 .NOTES
     File Name  : New-MyEdgeGateway.ps1
     Author     : Markus Kraus
-    Version    : 1.0
+    Version    : 1.1
     State      : Ready
 
 .LINK
     https://mycloudrevolution.com/
 
 .EXAMPLE
-    New-MyEdgeGateway -Name "TestEdge" -OrgVDCName "TestVDC" -OrgName "TestOrg" -ExternalNetwork "ExternalNetwork" -IPAddress "192.168.100.1" -SubnetMask "255.255.255.0" -Gateway "192.168.100.254" -IPRangeStart ""192.168.100.2" -IPRangeEnd ""192.168.100.3" -Verbose
+    New-MyEdgeGateway -Name "TestEdge" -OrgVDCName "TestVDC" -OrgName "TestOrg" -Size compact -ExternalNetwork "ExternalNetwork" -IPAddress "192.168.100.1" -SubnetMask "255.255.255.0" -Gateway "192.168.100.254" -IPRangeStart ""192.168.100.2" -IPRangeEnd ""192.168.100.3" -Verbose
 
 .PARAMETER Name
     Name of the New Edge Gateway as String
@@ -35,6 +32,9 @@ Function New-MyEdgeGateway {
 .PARAMETER OrgName
     Org where the new Edge Gateway should be created as string
 
+.PARAMETER Size
+    Size of the new Edge Gateway as string
+
 .PARAMETER ExternalNetwork
      External Network of the new Edge Gateway as String
 
@@ -69,6 +69,10 @@ Function New-MyEdgeGateway {
         [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Org where the new Edge Gateway should be created as string")]
         [ValidateNotNullorEmpty()]
             [String] $OrgName,
+        [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Size of the new Edge Gateway as string")]
+        [ValidateNotNullorEmpty()]
+        [ValidateSet("compact","full")]
+            [String] $Size,
         [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="External Network of the New Edge Gateway as String")]
         [ValidateNotNullorEmpty()]
             [String] $ExternalNetwork,
@@ -113,7 +117,7 @@ Function New-MyEdgeGateway {
     $EdgeGateway.Name = $Name
     $EdgeGateway.Configuration = New-Object VMware.VimAutomation.Cloud.Views.GatewayConfiguration
     #$EdgeGateway.Configuration.BackwardCompatibilityMode = $false
-    $EdgeGateway.Configuration.GatewayBackingConfig = "compact"
+    $EdgeGateway.Configuration.GatewayBackingConfig = $Size
     $EdgeGateway.Configuration.UseDefaultRouteForDnsRelay = $false
     $EdgeGateway.Configuration.HaEnabled = $false
 

Modules/VMware-vCD-Module/functions/New-MyOrg.psm1

@@ -1,6 +1,4 @@
-#Requires -Version 4
-#Requires -Modules VMware.VimAutomation.Cloud, @{ModuleName="VMware.VimAutomation.Cloud";ModuleVersion="6.3.0.0"}
-Function New-MyOrg {
+Function New-MyOrg {
 <#
 .SYNOPSIS
     Creates a new vCD Org with Default Parameters

Modules/VMware-vCD-Module/functions/New-MyOrgAdmin.psm1

@@ -1,6 +1,4 @@
-#Requires -Version 4
-#Requires -Modules VMware.VimAutomation.Cloud, @{ModuleName="VMware.VimAutomation.Cloud";ModuleVersion="6.3.0.0"}
-Function New-MyOrgAdmin {
+Function New-MyOrgAdmin {
 <#
 .SYNOPSIS
     Creates a new vCD Org Admin with Default Parameters

Modules/VMware-vCD-Module/functions/New-MyOrgNetwork.psm1

@@ -0,0 +1,166 @@
+Function New-MyOrgNetwork {
+    <#
+    .SYNOPSIS
+        Creates a new Org Network with Default Parameters
+
+    .DESCRIPTION
+
+    .NOTES
+        File Name  : New-MyOrgNetwork.ps1
+        Author     : Markus Kraus
+        Version    : 1.1
+        State      : Ready
+
+    .LINK
+        https://mycloudrevolution.com
+
+    .EXAMPLE
+        New-MyOrgNetwork -Name Test -OrgVdcName "Test-OrgVDC" -OrgName "Test-Org" -EdgeName "Test-OrgEdge" -SubnetMask 255.255.255.0 -Gateway 192.168.66.1 -IPRangeStart 192.168.66.100 -IPRangeEnd 192.168.66.200
+
+    .EXAMPLE
+        New-MyOrgNetwork -Name Test -OrgVdcName "Test-OrgVDC" -OrgName "Test-Org" -EdgeName "Test-OrgEdge" -SubnetMask 255.255.255.0 -Gateway 192.168.66.1 -IPRangeStart 192.168.66.100 -IPRangeEnd 192.168.66.200 -Shared:$False
+
+    .EXAMPLE
+        $params = @{ 'Name' = 'Test';
+                    'OrgVdcName'= 'Test-OrgVDC';
+                    'OrgName'='Test-Org';
+                    'EdgeName'='Test-OrgEdge';
+                    'SubnetMask' = '255.255.255.0';
+                    'Gateway' = '192.168.66.1';
+                    'IPRangeStart' = '192.168.66.100';
+                    'IPRangeEnd' = '192.168.66.200'
+                    }
+        New-MyOrgNetwork @params -Verbose
+
+    .PARAMETER Name
+        Name of the New Org Network as String
+
+    .PARAMETER OrgVDCName
+        OrgVDC where the new Org Network should be created as string
+
+    .PARAMETER OrgName
+        Org where the newOrg Networkshould be created as string
+
+    .PARAMETER EdgeName
+        Edge Gateway Name for the new Org Network as String
+
+    .PARAMETER SubnetMask
+         Subnet Mask of the New Org Network as IP Address
+
+    .PARAMETER Gateway
+         Gateway of the New Org Network as IP Address
+
+    .PARAMETER IPRangeStart
+        IP Range Start of the New Org Network as IP Address
+
+    .PARAMETER IPRangeEnd
+         IP Range End of the New Org Network as IP Address
+
+    .PARAMETER Shared
+         Switch for Shared OrgVDC Network
+
+         Default: $True
+
+    .PARAMETER Timeout
+        Timeout for the Org Network to become Ready
+
+        Default: 120s
+
+    #>
+        Param (
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Name of the New Org Network as String")]
+            [ValidateNotNullorEmpty()]
+                [String] $Name,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="OrgVDC where the new Org Network should be created as string")]
+            [ValidateNotNullorEmpty()]
+                [String] $OrgVdcName,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Org where the new Org Network should be created as string")]
+            [ValidateNotNullorEmpty()]
+                [String] $OrgName,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Edge Gateway Name for the new Org Network as String")]
+            [ValidateNotNullorEmpty()]
+                [String] $EdgeName,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Subnet Mask of the New Org Network as IP Address")]
+            [ValidateNotNullorEmpty()]
+                [IPAddress] $SubnetMask,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Gateway of the New Org Network as IP Address")]
+            [ValidateNotNullorEmpty()]
+                [IPAddress] $Gateway,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="IP Range Start the New Org Network as IP Address")]
+            [ValidateNotNullorEmpty()]
+                [IPAddress] $IPRangeStart,
+            [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="IP Range End the New Org Network as IP Address")]
+            [ValidateNotNullorEmpty()]
+                [IPAddress] $IPRangeEnd,
+            [Parameter(Mandatory=$False, ValueFromPipeline=$False, HelpMessage="Switch for Shared OrgVDC Network")]
+            [ValidateNotNullorEmpty()]
+                [Bool] $Shared = $True,
+            [Parameter(Mandatory=$False, ValueFromPipeline=$False,HelpMessage="Timeout for the Org Network to become Ready")]
+            [ValidateNotNullorEmpty()]
+                [int] $Timeout = 120
+        )
+        Process {
+
+        ## Get Org vDC
+        Write-Verbose "Get Org vDC"
+        [Array] $orgVdc = Get-Org -Name $OrgName | Get-OrgVdc -Name $OrgVdcName
+
+        if ( $orgVdc.Count -gt 1) {
+            throw "Multiple OrgVdcs found!"
+            }
+            elseif ( $orgVdc.Count -lt 1) {
+                throw "No OrgVdc found!"
+                }
+        $orgVdcView = $orgVdc| Get-CIView
+
+        ## Get EdgeGateway
+        Write-Verbose "Get EdgeGateway"
+        [Array] $edgeGateway = Search-Cloud -QueryType EdgeGateway -Name $EdgeName | Get-CIView
+        if ( $edgeGateway.Count -gt 1) {
+            throw "Multiple EdgeGateways found!"
+            }
+            elseif ( $edgeGateway.Count -lt 1) {
+                throw "No EdgeGateway found!"
+                }
+
+        ## Define Org Network
+        Write-Verbose "Define Org Network"
+        $OrgNetwork = new-object vmware.vimautomation.cloud.views.orgvdcnetwork
+        $OrgNetwork.name = $Name
+        $OrgNetwork.edgegateway = $edgeGateway.id
+        $OrgNetwork.isshared = $Shared
+
+        $OrgNetwork.configuration = new-object vmware.vimautomation.cloud.views.networkconfiguration
+        $OrgNetwork.configuration.fencemode = "natRouted"
+        $OrgNetwork.configuration.ipscopes = new-object vmware.vimautomation.cloud.views.ipscopes
+
+        $Scope = new-object vmware.vimautomation.cloud.views.ipScope
+        $Scope.gateway = $Gateway
+        $Scope.netmask = $SubnetMask
+
+        $Scope.ipranges = new-object vmware.vimautomation.cloud.views.ipranges
+        $Scope.ipranges.iprange = new-object vmware.vimautomation.cloud.views.iprange
+        $Scope.ipranges.iprange[0].startaddress = $IPRangeStart
+        $Scope.ipranges.iprange[0].endaddress = $IPRangeEnd
+
+        $OrgNetwork.configuration.ipscopes.ipscope += $Scope
+
+        ## Create Org Network
+        Write-Verbose "Create Org Network"
+        $CreateOrgNetwork = $orgVdcView.CreateNetwork($OrgNetwork)
+
+        ## Wait for Org Network to become Ready
+        Write-Verbose "Wait for Org Network to become Ready"
+        while(!(Get-OrgVdcNetwork -Id $CreateOrgNetwork.Id -ErrorAction SilentlyContinue)){
+            $i++
+            Start-Sleep 5
+            if($i -gt $Timeout) { Write-Error "Creating Org Network."; break}
+            Write-Progress -Activity "Creating Org Network" -Status "Wait for Network to become Ready..."
+        }
+        Write-Progress -Activity "Creating Org Network" -Completed
+        Start-Sleep 1
+
+        Get-OrgVdcNetwork -Id $CreateOrgNetwork.Id | Select-Object Name, OrgVdc, NetworkType, DefaultGateway, Netmask, StaticIPPool, @{ N='isShared'; E = {$_.ExtensionData.isShared} } | Format-Table -AutoSize
+
+        }
+    }

Modules/VMware-vCD-Module/functions/New-MyOrgVdc.psm1

@@ -1,6 +1,4 @@
-#Requires -Version 4
-#Requires -Modules VMware.VimAutomation.Cloud, @{ModuleName="VMware.VimAutomation.Cloud";ModuleVersion="6.3.0.0"}
-Function New-MyOrgVdc {
+Function New-MyOrgVdc {
 <#
 .SYNOPSIS
     Creates a new vCD Org VDC with Default Parameters
@@ -9,7 +7,6 @@ Function New-MyOrgVdc {
     Creates a new vCD Org VDC with Default Parameters
 
     Default Parameters are:
-    * Allocation Model
     * Network Quota
     * VM Quota
     * 'vCpu In Mhz'
@@ -20,27 +17,38 @@ Function New-MyOrgVdc {
 .NOTES
     File Name  : New-MyOrgVdc.ps1
     Author     : Markus Kraus
-    Version    : 1.2
+    Version    : 1.3
     State      : Ready
 
 .LINK
     https://mycloudrevolution.com/
 
 .EXAMPLE
-    New-MyOrgVdc -Name "TestVdc" -CPULimit 1000 -MEMLimit 1000 -StorageLimit 1000 -StorageProfile "Standard-DC01" -NetworkPool "NetworkPool-DC01" -ProviderVDC "Provider-VDC-DC01" -Org "TestOrg" -ExternalNetwork "External_OrgVdcNet"
+    New-MyOrgVdc -Name "TestVdc" -AllocationModel AllocationPool -CPULimit 1000 -MEMLimit 1000 -StorageLimit 1000 -StorageProfile "Standard-DC01" -NetworkPool "NetworkPool-DC01" -ProviderVDC "Provider-VDC-DC01" -Org "TestOrg" -ExternalNetwork "External_OrgVdcNet"
 
 .EXAMPLE
-    New-MyOrgVdc -Name "TestVdc" -CPULimit 1000 -MEMLimit 1000 -StorageLimit 1000 -StorageProfile "Standard-DC01" -NetworkPool "NetworkPool-DC01" -ProviderVDC "Provider-VDC-DC01" -Org "TestOrg"
+    New-MyOrgVdc -Name "TestVdc" -AllocationModel AllocationVApp -StorageLimit 1000 -StorageProfile "Standard-DC01" -NetworkPool "NetworkPool-DC01" -ProviderVDC "Provider-VDC-DC01" -Org "TestOrg"
 
 .PARAMETER Name
     Name of the New Org VDC as String
 
+.PARAMETER AllocationModel
+    Allocation Model of the New Org VDC as String
+
 .PARAMETER CPULimit
     CPU Limit (MHz) of the New Org VDC as String
 
+    Default: 0 (Unlimited)
+
+    Note: If AllocationModel is not AllocationVApp (Pay as you go), a limit needs to be set
+
 .PARAMETER MEMLimit
     Memory Limit (MB) of the New Org VDC as String
 
+    Default: 0 (Unlimited)
+
+    Note: If AllocationModel is not AllocationVApp (Pay as you go), a limit needs to be set
+
 .PARAMETER StorageLimit
     Storage Limit (MB) of the New Org VDC as String
 
@@ -76,12 +84,16 @@ Function New-MyOrgVdc {
         [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Name of the New Org VDC as String")]
         [ValidateNotNullorEmpty()]
             [String] $Name,
-        [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="CPU Limit (MHz) of the New Org VDC as String")]
+        [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Allocation Model of the New Org VDC as String")]
         [ValidateNotNullorEmpty()]
-            [int] $CPULimit,
-        [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Memory Limit (MB) of the New Org VDC as String")]
+        [ValidateSet("AllocationPool","AllocationVApp")]
+            [String] $AllocationModel,
+        [Parameter(Mandatory=$False, ValueFromPipeline=$False, HelpMessage="CPU Limit (MHz) of the New Org VDC as String")]
         [ValidateNotNullorEmpty()]
-            [int] $MEMLimit,
+            [int] $CPULimit = 0,
+        [Parameter(Mandatory=$False, ValueFromPipeline=$False, HelpMessage="Memory Limit (MB) of the New Org VDC as String")]
+        [ValidateNotNullorEmpty()]
+            [int] $MEMLimit = 0,
         [Parameter(Mandatory=$True, ValueFromPipeline=$False, HelpMessage="Storage Limit (MB) of the New Org VDC as String")]
         [ValidateNotNullorEmpty()]
             [int] $StorageLimit,
@@ -117,7 +129,7 @@ Function New-MyOrgVdc {
         $providerVdcRef = New-Object VMware.VimAutomation.Cloud.Views.Reference
         $providerVdcRef.Href = $OrgVdcproviderVdc.Href
         $adminVdc.ProviderVdcReference = $providerVdcRef
-        $adminVdc.AllocationModel = "AllocationPool"
+        $adminVdc.AllocationModel = $AllocationModel
         $adminVdc.ComputeCapacity = New-Object VMware.VimAutomation.Cloud.Views.ComputeCapacity
         $adminVdc.ComputeCapacity.Cpu = New-Object VMware.VimAutomation.Cloud.Views.CapacityWithUsage
         $adminVdc.ComputeCapacity.Cpu.Units = "MHz"
@@ -132,8 +144,8 @@ Function New-MyOrgVdc {
         $adminVdc.StorageCapacity.Limit = $StorageLimit
         $adminVdc.NetworkQuota = 10
         $adminVdc.VmQuota = 0
-        $adminVdc.VCpuInMhz = 1000
-        $adminVdc.VCpuInMhz2 = 1000
+        $adminVdc.VCpuInMhz = 2000
+        $adminVdc.VCpuInMhz2 = 2000
         $adminVdc.UsesFastProvisioning = $false
         $adminVdc.IsThinProvision = $true
 
@@ -143,20 +155,21 @@ Function New-MyOrgVdc {
         $orgVdc = $orgED.CreateVdc($adminVdc)
 
         ## Wait for getting Ready
-        Write-Verbose "Wait for getting Ready"
+        Write-Verbose "Wait for OrgVdc getting Ready after creation"
         $i = 0
         while(($orgVdc = Get-OrgVdc -Name $Name -Verbose:$false).Status -eq "NotReady"){
             $i++
             Start-Sleep 2
-            if($i -gt $Timeout) { Write-Error "Creating Org Failed."; break}
-            Write-Progress -Activity "Creating Org" -Status "Wait for Org to become Ready..."
+            if($i -gt $Timeout) { Write-Error "Creating OrgVdc Failed."; break}
+            Write-Progress -Activity "Creating OrgVdc" -Status "Wait for OrgVdc to become Ready..."
             }
-        Write-Progress -Activity "Creating Org" -Completed
+        Write-Progress -Activity "Creating OrgVdc" -Completed
         Start-Sleep 2
 
         ## Search given Storage Profile
         Write-Verbose "Search given Storage Profile"
-        $ProVdcStorageProfile = search-cloud -QueryType ProviderVdcStorageProfile -Name $StorageProfile | Get-CIView
+        $Filter = "ProviderVdc==" + $OrgVdcproviderVdc.Id
+        $ProVdcStorageProfile = search-cloud -QueryType ProviderVdcStorageProfile -Name $StorageProfile -Filter $Filter | Get-CIView
 
         ## Create Storage Profile Object with Settings
         Write-Verbose "Create Storage Profile Object with Settings"
@@ -174,14 +187,14 @@ Function New-MyOrgVdc {
         $orgVdc.ExtensionData.CreateVdcStorageProfile($UpdateParams)
 
         ## Wait for getting Ready
-        Write-Verbose "Wait for getting Ready"
+        Write-Verbose "Wait for OrgVdc getting Ready after update"
         while(($orgVdc = Get-OrgVdc -Name $name -Verbose:$false).Status -eq "NotReady"){
             $i++
             Start-Sleep 1
-            if($i -gt $Timeout) { Write-Error "Update Org Failed."; break}
-            Write-Progress -Activity "Updating Org" -Status "Wait for Org to become Ready..."
+            if($i -gt $Timeout) { Write-Error "Update OrgVdc Failed."; break}
+            Write-Progress -Activity "Updating OrgVdc" -Status "Wait for OrgVdc to become Ready..."
             }
-        Write-Progress -Activity "Updating Org" -Completed
+        Write-Progress -Activity "Updating OrgVdc" -Completed
         Start-Sleep 1
 
         ## Search Any-StorageProfile

Modules/VMware.CSP/VMware.CSP.psm1

@@ -0,0 +1,97 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Get-CSPAccessToken {
+    <#
+        .NOTES
+        ===========================================================================
+        Created by:     William Lam
+        Date:           07/23/2018
+        Organization:   VMware
+        Blog:           https://www.virtuallyghetto.com
+        Twitter:        @lamw
+        ===========================================================================
+
+        .DESCRIPTION
+            Converts a Refresh Token from the VMware Console Services Portal
+            to CSP Access Token to access CSP API
+        .PARAMETER RefreshToken
+            The Refresh Token from the VMware Console Services Portal
+        .EXAMPLE
+            Get-CSPAccessToken -RefreshToken $RefreshToken
+    #>
+    Param (
+        [Parameter(Mandatory=$true)][String]$RefreshToken
+    )
+
+    $results = Invoke-WebRequest -Uri "https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize" -Method POST -Headers @{accept='application/json'} -Body "refresh_token=$RefreshToken"
+    if($results.StatusCode -ne 200) {
+        Write-Host -ForegroundColor Red "Failed to retrieve Access Token, please ensure your VMC Refresh Token is valid and try again"
+        break
+    }
+    $accessToken = ($results | ConvertFrom-Json).access_token
+    Write-Host "CSP Auth Token has been successfully retrieved and saved to `$env:cspAuthToken"
+    $env:cspAuthToken = $accessToken
+}
+
+Function Get-CSPServices {
+    <#
+        .NOTES
+        ===========================================================================
+        Created by:     William Lam
+        Date:           07/23/2018
+        Organization:   VMware
+        Blog:           https://www.virtuallyghetto.com
+        Twitter:        @lamw
+        ===========================================================================
+
+        .DESCRIPTION
+            Returns the list of CSP Services avialable for given user
+        .EXAMPLE
+            Get-CSPServices
+    #>
+    If (-Not $env:cspAuthToken) { Write-error "CSP Auth Token not found, please run Get-CSPAccessToken" } Else {
+        $results = Invoke-WebRequest -Uri "https://console.cloud.vmware.com/csp/gateway/slc/api/definitions?expand=1" -Method GET -ContentType "application/json" -UseBasicParsing -Headers @{"csp-auth-token"="$env:cspAuthToken"}
+        ((($results.Content) | ConvertFrom-Json).results | where {$_.visible -eq $true}).displayName
+    }
+}
+
+Function Get-CSPRefreshTokenExpiry {
+    <#
+        .NOTES
+        ===========================================================================
+        Created by:     William Lam
+        Date:           01/10/2019
+        Organization:   VMware
+        Blog:           https://www.virtuallyghetto.com
+        Twitter:        @lamw
+        ===========================================================================
+
+        .DESCRIPTION
+            Retrieve the expiry for a given CSP Refresh Token
+        .PARAMETER RefreshToken
+            Retrieve the expiry for a given CSP Refresh Token
+        .EXAMPLE
+            Get-CSPRefreshTokenExpiry -RefreshToken $RefreshToken
+    #>
+    Param (
+        [Parameter(Mandatory=$true)][String]$RefreshToken
+    )
+
+    $body = @{"tokenValue"="$RefreshToken"}
+    $json = $body | ConvertTo-Json
+    $results = Invoke-WebRequest -Uri "https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/details" -Method POST -ContentType "application/json" -UseBasicParsing -Body $json
+    $tokenDetails = (($results.Content) | ConvertFrom-Json)
+
+    $createDate = (Get-Date -Date "01/01/1970").AddMilliseconds($tokenDetails.createdAt).ToLocalTime()
+    $usedDate = (Get-Date -Date "01/01/1970").AddMilliseconds($tokenDetails.lastUsedAt).ToLocalTime()
+    $expiryDate = (Get-Date -Date "01/01/1970").AddMilliseconds($tokenDetails.expiresAt).ToLocalTime()
+
+    $tmp = [pscustomobject] @{
+        LastUsedDate = $usedDate;
+        CreatedDate = $createDate;
+        ExpiryDate = $expiryDate;
+    }
+    $tmp | Format-List
+}

Modules/VMware.Community.CISTag/VMware.Community.CISTag.psd1

@@ -0,0 +1,128 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+#
+# Module manifest for module 'VMware.Community.CISTag'
+#
+# Generated by: Kyle Ruddy
+#
+# Generated on: 12/14/18
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'VMware.Community.CISTag.psm1'
+
+# Version number of this module.
+ModuleVersion = '1.0.0'
+
+# Supported PSEditions
+# CompatiblePSEditions = @()
+
+# ID used to uniquely identify this module
+GUID = 'a0803efd-6017-4049-bfc9-5983a5a0c348'
+
+# Author of this module
+Author = 'Kyle Ruddy'
+
+# Company or vendor of this module
+CompanyName = 'VMware'
+
+# Copyright statement for this module
+Copyright = '(c) VMware. All rights reserved.'
+
+# Description of the functionality provided by this module
+Description = 'Community sourced PowerShell Module for managing vSphere Tags via the CIS Endpoint'
+
+# Minimum version of the PowerShell engine required by this module
+PowerShellVersion = '4.0'
+
+# Name of the PowerShell host required by this module
+# PowerShellHostName = ''
+
+# Minimum version of the PowerShell host required by this module
+# PowerShellHostVersion = ''
+
+# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# DotNetFrameworkVersion = ''
+
+# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+# CLRVersion = ''
+
+# Processor architecture (None, X86, Amd64) required by this module
+# ProcessorArchitecture = ''
+
+# Modules that must be imported into the global environment prior to importing this module
+# RequiredModules = @()
+
+# Assemblies that must be loaded prior to importing this module
+# RequiredAssemblies = @()
+
+# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+# ScriptsToProcess = @()
+
+# Type files (.ps1xml) to be loaded when importing this module
+# TypesToProcess = @()
+
+# Format files (.ps1xml) to be loaded when importing this module
+# FormatsToProcess = @()
+
+# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+# NestedModules = @()
+
+# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+FunctionsToExport = 'Get-CISTag', 'Get-CISTagCategory', 'Get-CISTagAssignment', 'New-CISTag', 'New-CISTagCategory', 'New-CISTagAssignment', 'Remove-CISTag', 'Remove-CISTagCategory', 'Remove-CISTagAssignment'
+
+# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+# CmdletsToExport = '*'
+
+# Variables to export from this module
+# VariablesToExport = '*'
+
+# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+# AliasesToExport = '*'
+
+# DSC resources to export from this module
+# DscResourcesToExport = @()
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+PrivateData = @{
+
+    PSData = @{
+
+        # Tags applied to this module. These help with module discovery in online galleries.
+        # Tags = @()
+
+        # A URL to the license for this module.
+        # LicenseUri = ''
+
+        # A URL to the main website for this project.
+        # ProjectUri = ''
+
+        # A URL to an icon representing this module.
+        # IconUri = ''
+
+        # ReleaseNotes of this module
+        # ReleaseNotes = ''
+
+    } # End of PSData hashtable
+
+} # End of PrivateData hashtable
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+# DefaultCommandPrefix = ''
+
+}
+

Modules/VMware.Community.CISTag/VMware.Community.CISTag.psm1

@@ -0,0 +1,774 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+function Get-CISTag {
+<#
+.SYNOPSIS
+    Gathers tag information from the CIS REST API endpoint
+.DESCRIPTION
+    Will provide a list of tags
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag name which should be retreived
+.PARAMETER Category
+    Tag category name which should be retreived
+.PARAMETER Id
+    Tag ID which should be retreived
+.EXAMPLE
+	Get-CISTag
+    Retreives all tag information
+.EXAMPLE
+	Get-CISTag -Name tagName
+    Retreives the tag information based on the specified name
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Low')]
+	param(
+	[Parameter(Mandatory=$false,Position=0,ValueFromPipelineByPropertyName=$true)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=1,ValueFromPipelineByPropertyName=$true)]
+    [String]$Category,
+    [Parameter(Mandatory=$false,Position=2,ValueFromPipelineByPropertyName=$true)]
+    [String]$Id
+  	)
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagSvc = Get-CisService -Name com.vmware.cis.tagging.tag
+        if ($PSBoundParameters.ContainsKey("Id")) {
+            $tagOutput = $tagSvc.get($Id)
+        } else {
+            if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                [Boolean]$vCenterConn = $true
+                $vCTagList = Get-Tag
+            } else {
+                $tagArray = @()
+                $tagIdList = $tagSvc.list() | Select-Object -ExpandProperty Value
+                [int]$counter = 1
+                foreach ($t in $tagIdList) {
+                    $tagArray += $tagSvc.get($t)
+                    $counter++
+                    if ($counter -gt 200) {Start-Sleep -Milliseconds 1; $counter = 1}
+                }
+            }
+            if ($PSBoundParameters.ContainsKey("Name")) {
+                if ($vCenterConn){
+                    $tagOutput = $vCTagList | Where-Object {$_.Name -eq $Name}
+                } else {$tagOutput = $tagArray | Where-Object {$_.Name -eq $Name}}
+            } elseif ($PSBoundParameters.ContainsKey("Category")) {
+                if ($vCenterConn){
+                    $tagOutput = $vCTagList | Where-Object {$_.Category -eq $Category}
+                } else {
+                    $tagCatid = Get-CISTagCategory -Name $Category | Select-Object -ExpandProperty Id
+                    $tagIdList = $tagSvc.list_tags_for_category($tagCatid)
+                    $tagArray2 = @()
+                    foreach ($t in $tagIdList) {
+                        $tagArray2 += $tagSvc.get($t)
+                    }
+                    $tagOutput = $tagArray2
+                }
+            } else {
+                if ($vCenterConn){$tagOutput = $vCTagList}
+                else {$tagOutput = $tagArray}
+            }
+        }
+        $tagOutput | Select-Object Id, Name, Description
+    }
+
+}
+
+function New-CISTag {
+<#
+.SYNOPSIS
+    Creates a new tag from the CIS REST API endpoint
+.DESCRIPTION
+    Will create a new tag
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag name which should be created
+.PARAMETER Category
+    Category name where the new tag should be associated
+.PARAMETER Description
+    Description for the new tag
+.PARAMETER CategoryID
+    Category ID where the new tag should be associated
+.EXAMPLE
+    New-CISTag -Name tagName -Category categoryName -Description "Tag Descrition"
+    Creates a new tag based on the specified name
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Medium')]
+    param(
+    [Parameter(Mandatory=$true,Position=0)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=1)]
+    [String]$Category,
+    [Parameter(Mandatory=$false,Position=2)]
+    [String]$Description,
+    [Parameter(Mandatory=$false,Position=3)]
+    [String]$CategoryID
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagSvc = Get-CisService -Name com.vmware.cis.tagging.tag
+        $tagCreateHelper = $tagSvc.Help.create.create_spec.Create()
+        $tagCreateHelper.name = $Name
+        if ($PSBoundParameters.ContainsKey("Category")) {
+            $tagCreateHelper.category_id = Get-CISTagCategory -Name $Category | Select-Object -ExpandProperty Id
+        } elseif ($PSBoundParameters.ContainsKey("CategoryId")) {
+            $tagCreateHelper.category_id = $CategoryID
+        } else {Write-Warning "No Category input found. Add a Category name or ID."; break}
+        if ($PSBoundParameters.ContainsKey("Description")) {
+            $tagCreateHelper.description = $Description
+        } else {
+            $tagCreateHelper.description = ""
+        }
+        $tagNewId = $tagSvc.create($tagCreateHelper)
+        Get-CISTag -Id $tagNewId
+    }
+
+}
+
+function Remove-CISTag {
+<#
+.SYNOPSIS
+    Removes a tag from the CIS REST API endpoint
+.DESCRIPTION
+    Will delete a new tag
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag name which should be removed
+.PARAMETER ID
+    Tag ID which should be removed
+.EXAMPLE
+    Remove-CISTag -Name tagName
+    Removes a new tag based on the specified name
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'High')]
+    param(
+    [Parameter(Mandatory=$false,Position=0,ValueFromPipelineByPropertyName=$true)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=1,ValueFromPipelineByPropertyName=$true)]
+    [String]$ID
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagSvc = Get-CisService -Name com.vmware.cis.tagging.tag
+        if ($ID) {
+            $tagSvc.delete($ID)
+        } else {
+            $tagId = Get-CISTag -Name $Name | select -ExpandProperty Id
+            if ($tagId) {$tagSvc.delete($tagId)}
+            else {Write-Warning "No valid tag found."}
+        }
+    }
+}
+
+function Get-CISTagCategory {
+<#
+.SYNOPSIS
+    Gathers tag category information from the CIS REST API endpoint
+.DESCRIPTION
+    Will provide a list of tag categories
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag category name which should be retreived
+.PARAMETER Id
+    Tag category ID which should be retreived
+.EXAMPLE
+    Get-CISTagCategory
+    Retreives all tag category information
+.EXAMPLE
+    Get-CISTagCategory -Name tagCategoryName
+    Retreives the tag category information based on the specified name
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Low')]
+    param(
+    [Parameter(Mandatory=$false,Position=0,ValueFromPipelineByPropertyName=$true)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=2,ValueFromPipelineByPropertyName=$true)]
+    [String]$Id
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagCatSvc = Get-CisService -Name com.vmware.cis.tagging.category
+        if ($PSBoundParameters.ContainsKey("Id")) {
+            $tagCatOutput = $tagCatSvc.get($Id)
+        } else {
+            $tagCatArray = @()
+            $tagCatIdList = $tagCatSvc.list() | Select-Object -ExpandProperty Value
+            foreach ($tc in $tagCatIdList) {
+                $tagCatArray += $tagCatSvc.get($tc)
+            }
+            if ($PSBoundParameters.ContainsKey("Name")) {
+                $tagCatOutput = $tagCatArray | Where-Object {$_.Name -eq $Name}
+            } else {
+                $tagCatOutput = $tagCatArray
+            }
+        }
+        $tagCatOutput | Select-Object Id, Name, Description, Cardinality
+    }
+
+}
+
+function New-CISTagCategory {
+<#
+.SYNOPSIS
+    Creates a new tag category from the CIS REST API endpoint
+.DESCRIPTION
+    Will create a new tag category
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag category name which should be created
+.PARAMETER Description
+    Tag category ID which should be retreived
+.PARAMETER Cardinality
+    Tag category ID which should be retreived
+.PARAMETER AssociableTypes
+    Tag category ID which should be retreived
+.EXAMPLE
+    New-CISTagCategory -Name NewTagCategoryName -Description "New Tag Category Description" -Cardinality "Single" -AssociableTypes
+    Creates a new tag category with the specified information
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Medium')]
+    param(
+    [Parameter(Mandatory=$true,Position=0)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=1)]
+    [String]$Description,
+    [Parameter(Mandatory=$false,Position=2)]
+    [ValidateSet("SINGLE","MULTIPLE")]
+    [String]$Cardinality = "SINGLE",
+    [Parameter(Mandatory=$false,Position=3)]
+    [ValidateSet("All", "Cluster", "Datacenter", "Datastore", "DatastoreCluster", "DistributedPortGroup", "DistributedSwitch", "Folder", "ResourcePool", "VApp", "VirtualPortGroup", "VirtualMachine", "VMHost")]
+    [String]$AssociableTypes = "All"
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagCatSvc = Get-CisService -Name com.vmware.cis.tagging.category
+        $tagCatCreateHelper = $tagCatSvc.Help.create.create_spec.Create()
+        $tagCatCreateHelper.name = $Name
+        if ($PSBoundParameters.ContainsKey("Description")) {
+            $tagCatCreateHelper.description = $Description
+        } else {$tagCatCreateHelper.description = ""}
+        $tagCatCreateHelper.cardinality = $Cardinality
+        $tagCatCreateAssocTypeHelper = $tagCatSvc.help.create.create_spec.associable_types.create()
+        $tagCatCreateAssocTypeHelper.Add($AssociableTypes)
+        $tagCatCreateHelper.associable_types = $tagCatCreateAssocTypeHelper
+        $tagCatNewId = $tagCatSvc.create($tagCatCreateHelper)
+        Get-CISTagCategory -Id $tagCatNewId
+    }
+
+}
+
+function Remove-CISTagCategory {
+<#
+.SYNOPSIS
+    Removes tag category information from the CIS REST API endpoint
+.DESCRIPTION
+    Will remove a tag category
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Name
+    Tag category name which should be removed
+.PARAMETER Id
+    Tag category ID which should be removed
+.EXAMPLE
+    Remove-CISTagCategory -Name tagCategoryName
+    Removes the tag category information based on the specified name
+
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'High')]
+    param(
+    [Parameter(Mandatory=$false,Position=0,ValueFromPipelineByPropertyName=$true)]
+    [String]$Name,
+    [Parameter(Mandatory=$false,Position=2,ValueFromPipelineByPropertyName=$true)]
+    [String]$Id
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagCatSvc = Get-CisService -Name com.vmware.cis.tagging.category
+        if ($PSBoundParameters.ContainsKey("Id")) {
+            $tagCatSvc.delete($Id)
+        } elseif ($PSBoundParameters.ContainsKey("Name")) {
+            $tagCatId = Get-CISTagCategory -Name $Name | Select-Object -ExpandProperty Id
+            $tagCatSvc.delete($tagCatId)
+        } else {Write-Warning "No tag category found."}
+    }
+}
+
+function Get-CISTagAssignment {
+<#
+.SYNOPSIS
+    Displays a list of the tag assignments from the CIS REST API endpoint
+.DESCRIPTION
+    Will provide a list of the tag assignments
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Category
+    Tag category name which should be referenced
+.PARAMETER Entity
+    Object name which should be retreived
+.PARAMETER ObjectId
+    Object ID which should be retreived
+.EXAMPLE
+    Get-CISTagAssignment
+    Retreives all tag assignment information
+.EXAMPLE
+    Get-CISTagAssignment -Entity VMName
+    Retreives all tag assignments for the VM name
+.EXAMPLE
+    Get-CISTagAssignment -ObjectId 'vm-11'
+    Retreives all tag assignments for the VM object
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Low')]
+    param(
+    [Parameter(Mandatory=$false,Position=0)]
+    [String]$Category,
+    [Parameter(Mandatory=$false,Position=1)]
+    [String]$Entity,
+    [Parameter(Mandatory=$false,Position=2,ValueFromPipelineByPropertyName=$true)]
+    [String]$ObjectId
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagOutput = @()
+        [Boolean]$vCenterConn = $false
+        $tagAssocSvc = Get-CisService -Name com.vmware.cis.tagging.tag_association
+        if ($PSBoundParameters.ContainsKey("ObjectId")) {
+            if ($ObjectId.split('-')[0] -eq 'vm') {
+                $objType = "VirtualMachine"
+            } elseif ($ObjectId.Split('-')[0] -eq 'datastore') {
+                $objType = 'Datastore'
+            } else {Write-Warning 'Only VirtualMachine and Datastore types currently supported.'; break}
+            $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+            $objObject.id = $ObjectId
+            $objObject.type = $objType
+            $tagIdOutput = $tagAssocSvc.list_attached_tags($objObject)
+        } elseif ($PSBoundParameters.ContainsKey("Entity")) {
+            if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                [Boolean]$vCenterConn = $true
+                $viObject = (Get-Inventory -Name $Entity).ExtensionData.MoRef
+                $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                $objObject.id = $viObject.Value
+                $objObject.type = $viObject.type
+            } else {
+                $vmSvc = Get-CisService -Name com.vmware.vcenter.vm
+                $filterVmNameObj = $vmsvc.help.list.filter.create()
+                $filterVmNameObj.names.add($Entity) | Out-Null
+                $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                if ($objId) {$objType = "VirtualMachine"}
+                else {
+                    $dsSvc = Get-CisService com.vmware.vcenter.datastore
+                    $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                    $filterDsNameObj.names.add($Entity) | Out-Null
+                    $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                    if ($objId) {$objType = "Datastore"}
+                    else {Write-Warning "No entities found."; break}
+                }
+                $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                $objObject.id = $objId
+                $objObject.type = $objType
+            }
+            $tagIdOutput = $tagAssocSvc.list_attached_tags($objObject)
+        } else {
+            $tagSvc = Get-CisService -Name com.vmware.cis.tagging.tag
+            $tagIdOutput = @()
+            $tagCategories = Get-CISTagCategory | Sort-Object -Property Name
+            if ($Category) {
+                $tagCatId = $tagCategories | Where-Object {$_.Name -eq $Category} | Select-Object -ExpandProperty Id
+                $tagIdOutput += $tagSvc.list_tags_for_category($tagCatId)
+            } else {
+                foreach ($tagCat in $tagCategories) {
+                    $tagIdOutput += $tagSvc.list_tags_for_category($tagCat.id)
+                }
+            }
+        }
+        $tagReference = Get-CISTag
+
+        if ($Entity -or $ObjectId) {
+            foreach ($tagId in $tagIdOutput) {
+                $tagAttObj = @()
+                if ($Entity) {
+                    $tagAttObj += $tagAssocSvc.list_attached_objects($tagId) | Where-Object {$_.type -eq $viObject.type -and $_.id -eq $viObject.Value}
+                } else {
+                    $tagAttObj += $tagAssocSvc.list_attached_objects($tagId) | Where-Object {$_.id -eq $ObjectId}
+                }
+                foreach ($obj in $tagAttObj) {
+                    if ($obj.type -eq "VirtualMachine") {
+                        if (-Not $vmSvc) {$vmSvc = Get-CisService -Name com.vmware.vcenter.vm}
+                        $filterVmObj = $vmsvc.help.list.filter.create()
+                        $filterVmObj.vms.add($obj.Id) | Out-Null
+                        $objName = $vmSvc.list($filterVmObj) | Select-Object -ExpandProperty Name
+                    } elseif ($obj.type -eq "Datastore") {
+                        if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                        $filterDsObj = $dsSvc.help.list.filter.create()
+                        $filterDsObj.datastores.add($obj.Id) | Out-Null
+                        $objName = $dsSvc.list($filterDsObj) | Select-Object -ExpandProperty Name
+                    } else {$objName = 'Object Not Found'}
+                    $tempObject = "" | Select-Object Tag, Entity
+                    $tempObject.Tag = $tagReference | Where-Object {$_.id -eq $tagId} | Select-Object -ExpandProperty Name
+                    $tempObject.Entity = $objName
+                    $tagOutput += $tempObject
+                }
+            }
+        } else {
+            foreach ($tagId in $tagIdOutput) {
+                $tagAttObj = @()
+                $tagAttObj += $tagAssocSvc.list_attached_objects($tagId)
+                if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                    [Boolean]$vCenterConn = $true
+                } elseif ($tagAttObj.Type -contains "VirtualMachine") {
+                    if (-Not $vmSvc) {$vmSvc = Get-CisService -Name com.vmware.vcenter.vm}
+                } elseif ($tagAttObj.Type -contains "Datastore") {
+                    if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                }
+                foreach ($obj in $tagAttObj) {
+                    if ($vCenterConn) {
+                        $newViObj = New-Object -TypeName VMware.Vim.ManagedObjectReference
+                        $newViObj.Type = $obj.type
+                        $newViObj.Value = $obj.id
+                        $objName = Get-View -Id $newViObj -Property Name | Select-Object -ExpandProperty Name
+                    } elseif ($obj.type -eq "VirtualMachine") {
+                        $filterVmObj = $vmsvc.help.list.filter.create()
+                        $filterVmObj.vms.add($obj.Id) | Out-Null
+                        $objName = $vmSvc.list($filterVmObj) | Select-Object -ExpandProperty Name
+                    } elseif ($obj.type -eq "Datastore") {
+                        $filterDsObj = $dsSvc.help.list.filter.create()
+                        $filterDsObj.datastores.add($obj.Id) | Out-Null
+                        $objName = $dsSvc.list($filterDsObj) | Select-Object -ExpandProperty Name
+                    } else {$objName = 'Object Not Found'}
+                    $tempObject = "" | Select-Object Tag, Entity
+                    $tempObject.Tag = $tagReference | Where-Object {$_.id -eq $tagId} | Select-Object -ExpandProperty Name
+                    $tempObject.Entity = $objName
+                    $tagOutput += $tempObject
+                }
+            }
+        }
+        return $tagOutput
+    }
+}
+
+function New-CISTagAssignment {
+<#
+.SYNOPSIS
+    Creates new tag assignments from the CIS REST API endpoint
+.DESCRIPTION
+    Will create new tag assignments
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Tag
+    Tag name which should be referenced
+.PARAMETER Entity
+    Object name which should be retreived
+.PARAMETER TagId
+    Tag ID/s which should be referenced
+.PARAMETER ObjectId
+    Object ID which/s should be retreived
+.EXAMPLE
+    New-CISTagAssignment -Tag TagName -Entity VMName
+    Creates a tag assignment between the Tag name and the VM name
+.EXAMPLE
+    New-CISTagAssignment -TagId $tagId -ObjectId 'vm-11'
+    Creates a tag assignment between the Tag ID and the Object ID
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'Medium')]
+    param(
+    [Parameter(Mandatory=$false,Position=0)]
+    $Tag,
+    [Parameter(Mandatory=$false,Position=1)]
+    $Entity,
+    [Parameter(Mandatory=$false,Position=2)]
+    $TagId,
+    [Parameter(Mandatory=$false,Position=3)]
+    $ObjectId
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagAssocSvc = Get-CisService -Name com.vmware.cis.tagging.tag_association
+        if ($PSBoundParameters.ContainsKey("Tag") -and $PSBoundParameters.ContainsKey("Entity")) {
+            if ($Tag -is [array] -and $Entity -isnot [array]) {
+                $tagIdList = $tagAssocSvc.help.attach_multiple_tags_to_object.tag_ids.create()
+                foreach ($t in $Tag) {
+                    $tempId = Get-CISTag -Name $t | Select-Object -ExpandProperty Id
+                    $tagIdList.add($tempId) | Out-Null
+                }
+                if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                    $viObject = (Get-Inventory -Name $Entity).ExtensionData.MoRef
+                    $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                    $objObject.id = $viObject.Value
+                    $objObject.type = $viObject.type
+                } else {
+                    if (-Not $vmSvc) {$vmSvc = Get-CisService -Name com.vmware.vcenter.vm}
+                    $filterVmNameObj = $vmsvc.help.list.filter.create()
+                    $filterVmNameObj.names.add($Entity) | Out-Null
+                    $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                    if ($objId) {$objType = "VirtualMachine"}
+                    else {
+                        if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                        $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                        $filterDsNameObj.names.add($Entity) | Out-Null
+                        $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                        if ($objId) {$objType = "Datastore"}
+                        else {Write-Warning "No entities found."; break}
+                    }
+                    $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                    $objObject.id = $objId
+                    $objObject.type = $objType
+                }
+                $tagAssocSvc.attach_multiple_tags_to_object($objObject,$tagIdList) | Out-Null
+            } elseif ($Tag -isnot [array] -and $Entity -is [array]) {
+                $tagId = Get-CISTag -Name $Tag | Select-Object -ExpandProperty Id
+                $objList = $tagAssocSvc.help.attach_tag_to_multiple_objects.object_ids.create()
+                foreach ($e in $Entity) {
+                    if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                        $viObject = (Get-Inventory -Name $e).ExtensionData.MoRef
+                        $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                        $objObject.id = $viObject.Value
+                        $objObject.type = $viObject.type
+                    } else {
+                        if (-Not $vmSvc) {$vmSvc = Get-CisService -Name com.vmware.vcenter.vm}
+                        $filterVmNameObj = $vmsvc.help.list.filter.create()
+                        $filterVmNameObj.names.add($Entity) | Out-Null
+                        $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                        if ($objId) {$objType = "VirtualMachine"}
+                        else {
+                            if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                            $filterDsObj = $dsSvc.help.list.filter.create()
+                            $filterDsObj.datastores.add($obj.Id) | Out-Null
+                            $objId = $dsSvc.list($filterDsObj) | Select-Object -ExpandProperty Datastore
+                            if ($objId) {$objType = "Datastore"}
+                            else {Write-Warning "No entities found."; break}
+                        }
+                        $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                        $objObject.id = $objId
+                        $objObject.type = $objType
+                    }
+                    $objList.add($objObject) | Out-Null
+                }
+                $tagAssocSvc.attach_tag_to_multiple_objects($TagId,$objList) | Out-Null
+            } elseif ($Tag -isnot [array] -and $Entity -isnot [array]) {
+                $tagId = Get-CISTag -Name $Tag | Select-Object -ExpandProperty Id
+                if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                    $viObject = (Get-Inventory -Name $Entity).ExtensionData.MoRef
+                    $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                    $objObject.id = $viObject.Value
+                    $objObject.type = $viObject.type
+                } else {
+                    if (-Not $vmSvc) {$vmSvc = Get-CisService -Name com.vmware.vcenter.vm}
+                    $filterVmNameObj = $vmsvc.help.list.filter.create()
+                    $filterVmNameObj.names.add($Entity) | Out-Null
+                    $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                    if ($objId) {$objType = "VirtualMachine"}
+                    else {
+                        if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                        $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                        $filterDsNameObj.names.add($Entity) | Out-Null
+                        $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                        if ($objId) {$objType = "Datastore"}
+                        else {Write-Warning "No entities found."; break}
+                    }
+                    $objObject = $tagAssocSvc.help.list_attached_tags.object_id.create()
+                    $objObject.id = $objId
+                    $objObject.type = $objType
+                }
+                $tagAssocSvc.attach($TagId,$objObject) | Out-Null
+            }
+        } elseif ($PSBoundParameters.ContainsKey("TagId") -and $PSBoundParameters.ContainsKey("ObjectId")) {
+            if ($ObjectId.split('-')[0] -eq 'vm') {
+                $objType = "VirtualMachine"
+            } elseif ($ObjectId.Split('-')[0] -eq 'datastore') {
+                $objType = 'Datastore'
+            } else {Write-Warning 'Only VirtualMachine and Datastore types currently supported.'; break}
+            if ($TagId -is [array] -and $ObjectId -isnot [array]) {
+                $objObject = $tagAssocSvc.help.attach_multiple_tags_to_object.object_id.create()
+                $objObject.id = $ObjectId
+                $objObject.type = $objType
+                $tagIdList = $tagAssocSvc.help.attach_multiple_tags_to_object.tag_ids.create()
+                foreach ($tId in $TagId) {
+                    $tagIdList.add($tId) | Out-Null
+                }
+                $tagAssocSvc.attach_multiple_tags_to_object($objObject,$tagIdList) | Out-Null
+            } elseif ($TagId -isnot [array] -and $ObjectId -is [array]) {
+                $objList = $tagAssocSvc.help.attach_tag_to_multiple_objects.object_ids.create()
+                foreach ($obj in $ObjectId) {
+                    $objObject = $tagAssocSvc.help.attach_tag_to_multiple_objects.object_ids.element.create()
+                    $objObject.id = $obj
+                    $objObject.type = $objType
+                    $objList.add($objObject) | Out-Null
+                }
+                $tagAssocSvc.attach_tag_to_multiple_objects($TagId,$objList) | Out-Null
+            } elseif ($TagId -isnot [array] -and $ObjectId -isnot [array]) {
+                $objObject = $tagAssocSvc.help.attach.object_id.create()
+                $objObject.id = $ObjectId
+                $objObject.type = $objType
+                $tagAssocSvc.attach($TagId,$objObject) | Out-Null
+            }
+
+        } else {Write-Output "Multiple tags with multiple objects are not a supported call."}
+
+    }
+}
+
+function Remove-CISTagAssignment {
+<#
+.SYNOPSIS
+    Removes a tag assignment from the CIS REST API endpoint
+.DESCRIPTION
+    Will remove provided tag assignments
+.NOTES
+    Author:  Kyle Ruddy, @kmruddy
+.PARAMETER Tag
+    Tag name which should be removed
+.PARAMETER Entity
+    Object name which should be removed
+.PARAMETER TagId
+    Tag ID/s which should be removed
+.PARAMETER ObjectId
+    Object ID which/s should be removed
+.EXAMPLE
+    Remove-CISTagAssignment -TagId $tagId -ObjectId 'vm-11'
+    Removes the tag assignment between the Tag ID and the Object ID
+.EXAMPLE
+    Remove-CISTagAssignment -Tag TagName -Entity VMName
+    Removes the tag assignment between the Tag name and the Entity name
+#>
+[CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'High')]
+    param(
+    [Parameter(Mandatory=$false,Position=0,ValueFromPipelineByPropertyName=$true)]
+    $Tag,
+    [Parameter(Mandatory=$false,Position=1,ValueFromPipelineByPropertyName=$true)]
+    $Entity,
+    [Parameter(Mandatory=$false,Position=2)]
+    $TagId,
+    [Parameter(Mandatory=$false,Position=3)]
+    $ObjectId
+    )
+
+    If (-Not $global:DefaultCisServers) { Write-error "No CIS Connection found, please use the Connect-CisServer to connect" } Else {
+        $tagAssocSvc = Get-CisService -Name com.vmware.cis.tagging.tag_association
+        if ($PSBoundParameters.ContainsKey("Tag") -and $PSBoundParameters.ContainsKey("Entity")) {
+            if ($Tag -is [array] -and $Entity -isnot [array]) {
+                $tagIdList = $tagAssocSvc.help.detach_multiple_tags_from_object.tag_ids.create()
+                foreach ($t in $Tag) {
+                    $tempId = Get-CISTag -Name $t | Select-Object -ExpandProperty Id
+                    $tagIdList.add($tempId) | Out-Null
+                }
+                if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                    $viObject = (Get-Inventory -Name $Entity).ExtensionData.MoRef
+                    $objObject = $tagAssocSvc.help.detach_multiple_tags_from_object.object_id.create()
+                    $objObject.id = $viObject.Value
+                    $objObject.type = $viObject.type
+                } else {
+                    $vmSvc = Get-CisService -Name com.vmware.vcenter.vm
+                    $filterVmNameObj = $vmsvc.help.list.filter.create()
+                    $filterVmNameObj.names.add($Entity) | Out-Null
+                    $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                    if ($objId) {$objType = "VirtualMachine"}
+                    else {
+                        if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                        $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                        $filterDsNameObj.names.add($Entity) | Out-Null
+                        $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                        if ($objId) {$objType = "Datastore"}
+                        else {Write-Warning "No entities found."; break}
+                    }
+                    $objObject = $tagAssocSvc.help.detach_multiple_tags_from_object.object_id.create()
+                    $objObject.id = $objId
+                    $objObject.type = $objType
+                }
+                $tagAssocSvc.detach_multiple_tags_from_object($objObject,$tagIdList) | Out-Null
+            } elseif ($Tag -isnot [array] -and $Entity -is [array]) {
+                $tagId = Get-CISTag -Name $Tag | Select-Object -ExpandProperty Id
+                $objList = $tagAssocSvc.help.detach_tag_from_multiple_objects.object_ids.create()
+                foreach ($e in $Entity) {
+                    if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                        $viObject = (Get-Inventory -Name $e).ExtensionData.MoRef
+                        $objObject = $tagAssocSvc.help.detach_tag_from_multiple_objects.object_ids.element.create()
+                        $objObject.id = $viObject.Value
+                        $objObject.type = $viObject.type
+                    } else {
+                        $vmSvc = Get-CisService -Name com.vmware.vcenter.vm
+                        $filterVmNameObj = $vmsvc.help.list.filter.create()
+                        $filterVmNameObj.names.add($Entity) | Out-Null
+                        $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                        if ($objId) {$objType = "VirtualMachine"}
+                        else {
+                            if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                            $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                            $filterDsNameObj.names.add($Entity) | Out-Null
+                            $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                            if ($objId) {$objType = "Datastore"}
+                            else {Write-Warning "No entities found."; break}
+                        }
+                        $objObject = $tagAssocSvc.help.detach_tag_from_multiple_objects.object_ids.element.create()
+                        $objObject.id = $objId
+                        $objObject.type = $objType
+                    }
+                    $objList.add($objObject) | Out-Null
+                }
+                $tagAssocSvc.detach_tag_from_multiple_objects($TagId,$objList) | Out-Null
+            } elseif ($Tag -isnot [array] -and $Entity -isnot [array]) {
+                $tagId = Get-CISTag -Name $Tag | Select-Object -ExpandProperty Id
+                if ($global:DefaultVIServer -and $global:DefaultVIServer.Name -eq $global:DefaultCisServers.Name) {
+                    $viObject = (Get-Inventory -Name $Entity).ExtensionData.MoRef
+                    $objObject = $tagAssocSvc.help.detach.object_id.create()
+                    $objObject.id = $viObject.Value
+                    $objObject.type = $viObject.type
+                } else {
+                    $vmSvc = Get-CisService -Name com.vmware.vcenter.vm
+                    $filterVmNameObj = $vmsvc.help.list.filter.create()
+                    $filterVmNameObj.names.add($Entity) | Out-Null
+                    $objId = $vmSvc.list($filterVmNameObj) | Select-Object -ExpandProperty vm
+                    if ($objId) {$objType = "VirtualMachine"}
+                    else {
+                        if (-Not $dsSvc) {$dsSvc = Get-CisService -Name com.vmware.vcenter.datastore}
+                        $filterDsNameObj = $dsSvc.Help.list.filter.Create()
+                        $filterDsNameObj.names.add($Entity) | Out-Null
+                        $objId = $dsSvc.list($filterDsNameObj) | Select-Object -ExpandProperty datastore
+                        if ($objId) {$objType = "Datastore"}
+                        else {Write-Warning "No entities found."; break}
+                    }
+                    $objObject = $tagAssocSvc.help.detach.object_id.create()
+                    $objObject.id = $objId
+                    $objObject.type = $objType
+                }
+                $tagAssocSvc.detach($TagId,$objObject) | Out-Null
+            }
+        } elseif ($PSBoundParameters.ContainsKey("TagId") -and $PSBoundParameters.ContainsKey("ObjectId")) {
+            if ($ObjectId.split('-')[0] -eq 'vm') {
+                $objType = "VirtualMachine"
+            } elseif ($ObjectId.Split('-')[0] -eq 'datastore') {
+                $objType = 'Datastore'
+            }else {Write-Warning 'Only VirtualMachine types currently supported.'; break}
+            if ($TagId -is [array] -and $ObjectId -isnot [array]) {
+                $objObject = $tagAssocSvc.help.detach_multiple_tags_from_object.object_id.create()
+                $objObject.id = $ObjectId
+                $objObject.type = $objType
+                $tagIdList = $tagAssocSvc.help.detach_multiple_tags_from_object.tag_ids.create()
+                foreach ($tId in $TagId) {
+                    $tagIdList.add($tId) | Out-Null
+                }
+                $tagAssocSvc.detach_multiple_tags_from_object($objObject,$tagIdList) | Out-Null
+            } elseif ($TagId -isnot [array] -and $ObjectId -is [array]) {
+                $objList = $tagAssocSvc.help.detach_tag_from_multiple_objects.object_ids.create()
+                foreach ($obj in $ObjectId) {
+                    $objObject = $tagAssocSvc.help.detach_tag_from_multiple_objects.object_ids.element.create()
+                    $objObject.id = $obj
+                    $objObject.type = $objType
+                    $objList.add($objObject) | Out-Null
+                }
+                $tagAssocSvc.detach_tag_from_multiple_objects($TagId,$objList) | Out-Null
+            } elseif ($TagId -isnot [array] -and $ObjectId -isnot [array]) {
+                $objObject = $tagAssocSvc.help.detach.object_id.create()
+                $objObject.id = $ObjectId
+                $objObject.type = $objType
+                $tagAssocSvc.detach($TagId,$objObject) | Out-Null
+            }
+        } else {Write-Output "Multiple tags with multiple objects are not a supported call."}
+
+    }
+}

Modules/VMware.DRaaS/VMware.DRaaS.psm1

@@ -0,0 +1,260 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+Function Connect-DRaas {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Date:          05/23/2019
+    Organization:  VMware
+    Blog:          http://www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+
+    .SYNOPSIS
+        This cmdlet creates $global:draasConnection object containing the DRaaS URL along with CSP Token Header
+    .DESCRIPTION
+        This cmdlet creates $global:draasConnection object containing the DRaaS URL along with CSP Token Header
+    .EXAMPLE
+        Connect-DRaaS -RefreshToken $RefreshToken -OrgName $OrgName -SDDCName $SDDCName
+    .NOTES
+        You must be logged into VMC using Connect-VmcServer cmdlet
+#>
+    Param (
+        [Parameter(Mandatory=$true)][String]$RefreshToken,
+        [Parameter(Mandatory=$true)][String]$OrgName,
+        [Parameter(Mandatory=$true)][String]$SDDCName
+    )
+
+    If (-Not $global:DefaultVMCServers.IsConnected) { Write-error "No valid VMC Connection found, please use the Connect-VMC to connect"; break } Else {
+        $sddcService = Get-VmcService "com.vmware.vmc.orgs.sddcs"
+        $orgId = (Get-VMCOrg -Name $OrgName).Id
+        $sddcId = (Get-VMCSDDC -Name $SDDCName -Org $OrgName).Id
+        $sddc = $sddcService.get($orgId,$sddcId)
+
+    }
+
+    $results = Invoke-WebRequest -Uri "https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize" -Method POST -Headers @{accept='application/json'} -Body "refresh_token=$RefreshToken"
+    if($results.StatusCode -ne 200) {
+        Write-Host -ForegroundColor Red "Failed to retrieve Access Token, please ensure your VMC Refresh Token is valid and try again"
+        break
+    }
+    $accessToken = ($results | ConvertFrom-Json).access_token
+
+    $headers = @{
+        "csp-auth-token"="$accessToken"
+        "Content-Type"="application/json"
+        "Accept"="application/json"
+    }
+    $global:draasConnection = new-object PSObject -Property @{
+        'Server' = "https://vmc.vmware.com/vmc/draas/api/orgs/$orgId/sddcs/$sddcId/site-recovery"
+        'headers' = $headers
+    }
+    $global:draasConnection
+}
+
+Function Get-DRaas {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Date:          05/23/2019
+    Organization:  VMware
+    Blog:          http://www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+
+    .SYNOPSIS
+        Returns information about DRaaS configuration for a given SDDC
+    .DESCRIPTION
+        This cmdlet returns information about DRaaS configuration for a given SDDC. Can be used to monitor both activate and deactivate operations.
+    .EXAMPLE
+        Get-DRaas
+#>
+    Param (
+        [Switch]$Troubleshoot
+    )
+
+    If (-Not $global:draasConnection) { Write-error "No DRaaS Connection found, please use Connect-DRaaS" } Else {
+        $method = "GET"
+        $draasUrl = $global:draasConnection.Server
+        $draasVersionUrl = $global:draasConnection.Server + "/versions"
+
+        if($Troubleshoot) {
+            Write-Host -ForegroundColor cyan "`n[DEBUG] - $METHOD`n$draasUrl`n"
+        }
+
+        try {
+            if($PSVersionTable.PSEdition -eq "Core") {
+                $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers -SkipCertificateCheck
+            } else {
+                $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers
+            }
+        } catch {
+            if($_.Exception.Response.StatusCode -eq "Unauthorized") {
+                Write-Host -ForegroundColor Red "`nThe CSP session is no longer valid, please re-run the Connect-DRaaS cmdlet to retrieve a new token`n"
+                break
+            } else {
+                Write-Error "Error in retrieving DRaaS Information"
+                Write-Error "`n($_.Exception.Message)`n"
+                break
+            }
+        }
+
+        if($requests.StatusCode -eq 200) {
+            $json = ($requests.Content | ConvertFrom-Json)
+
+            $draasId = $json.id;
+            $draasState = $json.site_recovery_state;
+            $srmNode = $json.srm_node.ip_address;
+            $srmNodeState = $json.site_recovery_state;
+            $vrNode = $json.vr_node.ip_address;
+            $vrNodeState = $json.vr_node.state;
+            $draasUrl = $json.draas_h5_url;
+
+            if($srmNodeState -eq "ACTIVATED") {
+                if($Troubleshoot) {
+                    Write-Host -ForegroundColor cyan "`n[DEBUG] - $METHOD`n$draasVersionUrl`n"
+                }
+
+                try {
+                    if($PSVersionTable.PSEdition -eq "Core") {
+                        $requests = Invoke-WebRequest -Uri $draasVersionUrl -Method $method -Headers $global:draasConnection.headers -SkipCertificateCheck
+                    } else {
+                        $requests = Invoke-WebRequest -Uri $draasVersionUrl -Method $method -Headers $global:draasConnection.headers
+                    }
+                } catch {
+                    if($_.Exception.Response.StatusCode -eq "Unauthorized") {
+                        Write-Host -ForegroundColor Red "`nThe CSP session is no longer valid, please re-run the Connect-DRaaS cmdlet to retrieve a new token`n"
+                        break
+                    } else {
+                        Write-Error "Error in retrieving DRaaS Information"
+                        Write-Error "`n($_.Exception.Message)`n"
+                        break
+                    }
+                }
+
+                if($requests.StatusCode -eq 200) {
+                    $json = ($requests.Content | ConvertFrom-Json).node_versions
+
+                    $srmVersion,$srmDescription = ($json | where {$_.node_ip -eq $srmNode}).full_version.split("`n")
+                    $vrVersion,$vrDescription = ($json | where {$_.node_ip -eq $vrNode}).full_version.split("`n")
+
+                    $results = [pscustomobject] @{
+                        ID = $draasId;
+                        DRaaSState = $draasState;
+                        SRMNode = $srmNode;
+                        SRMVersion = $srmVersion;
+                        SRMNodeState = $srmNodeState;
+                        VRNode = $vrNode;
+                        VRVersion = $vrVersion;
+                        VRNodeState = $vrNodeState;
+                        DRaaSURL = $draasUrl;
+                    }
+
+                    $results
+                }
+            } elseif ($srmNodeState -eq "ACTIVATING" -or $srmNodeState -eq "DEACTIVATING") {
+                $results = [pscustomobject] @{
+                    ID = $draasId;
+                    DRaaSState = $draasState;
+                    SRMNode = $srmNode;
+                    SRMNodeState = $srmNodeState;
+                    VRNode = $vrNode;
+                    VRNodeState = $vrNodeState;
+                    DRaaSURL = $draasUrl;
+                }
+
+                $results
+            } else {
+                Write-Host "`nDRaaS is currently deactivated, please run Set-DRaas -Activate`n"
+            }
+        } else {
+            Write-Host "`nDRaaS has not been activated before, please run Set-DRaas -Activate`n"
+        }
+    }
+}
+
+
+Function Set-DRaas {
+<#
+    .NOTES
+    ===========================================================================
+    Created by:    William Lam
+    Date:          05/23/2019
+    Organization:  VMware
+    Blog:          http://www.virtuallyghetto.com
+    Twitter:       @lamw
+    ===========================================================================
+
+    .SYNOPSIS
+        Activate or deactivate DRaaS for a given SDDC
+    .DESCRIPTION
+        This cmdlet activates or deactivates DRaaS for a given SDDC
+    .EXAMPLE
+        Get-DRaas
+#>
+    Param (
+        [Switch]$Activate,
+        [Switch]$Deactivate,
+        [Switch]$Troubleshoot
+    )
+
+    If (-Not $global:draasConnection) { Write-error "No DRaaS Connection found, please use Connect-DRaaS" } Else {
+        $draasUrl = $global:draasConnection.server
+
+        if($Activate) {
+            $method = "POST"
+
+            if($Troubleshoot) {
+                Write-Host -ForegroundColor cyan "`n[DEBUG] - $METHOD`n$draasUrl`n"
+            }
+
+            try {
+                if($PSVersionTable.PSEdition -eq "Core") {
+                    $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers -SkipCertificateCheck
+                } else {
+                    $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers
+                }
+            } catch {
+                if($_.Exception.Response.StatusCode -eq "Unauthorized") {
+                    Write-Host -ForegroundColor Red "`nThe CSP session is no longer valid, please re-run the Connect-DRaaS cmdlet to retrieve a new token`n"
+                    break
+                } else {
+                    Write-Error "Error in activating DRaaS"
+                    Write-Error "`n($_.Exception.Message)`n"
+                    break
+                }
+            }
+            Write-Host "`nActivating DRaaS, this will take some time and you can monitor the progress using Get-DRaaS or using the VMC Console UI`n"
+        } elseif ($Deactivate) {
+            $method = "DELETE"
+
+            if($Troubleshoot) {
+                Write-Host -ForegroundColor cyan "`n[DEBUG] - $METHOD`n$draasUrl`n"
+            }
+
+            try {
+                if($PSVersionTable.PSEdition -eq "Core") {
+                    $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers -SkipCertificateCheck
+                } else {
+                    $requests = Invoke-WebRequest -Uri $draasUrl -Method $method -Headers $global:draasConnection.headers
+                }
+            } catch {
+                if($_.Exception.Response.StatusCode -eq "Unauthorized") {
+                    Write-Host -ForegroundColor Red "`nThe CSP session is no longer valid, please re-run the Connect-DRaaS cmdlet to retrieve a new token`n"
+                    break
+                } else {
+                    Write-Error "Error in deactivating DRaaS"
+                    Write-Error "`n($_.Exception.Message)`n"
+                    break
+                }
+            }
+            Write-Host "`nDeactivating DRaaS, this will take some time and you can monitor the progress using Get-DRaaS or the VMC Console UI`n"
+        } else {
+            Write-Error "Invalid Operation"
+        }
+    }
+}

Modules/VMware.HCX/VMware.HCX.psd1

@@ -0,0 +1,98 @@
+<#
+Copyright 2021 VMware, Inc.
+SPDX-License-Identifier: BSD-2-Clause
+#>
+
+#
+# Module manifest for module 'VMware.HCX'
+#
+# Generated by: wlam@vmware.com
+#
+# Generated on: 09/11/18
+#
+
+@{
+
+# Script module or binary module file associated with this manifest.
+RootModule = 'VMware.HCX.psm1'
+
+# Version number of this module.
+ModuleVersion = '1.0.2'
+
+# Supported PSEditions
+# CompatiblePSEditions = @()
+
+# ID used to uniquely identify this module
+GUID = '88898ed6-26e8-4dfa-a9de-10d3a12571de'
+
+# Author of this module
+Author = 'William Lam'
+
+# Company or vendor of this module
+CompanyName = 'VMware'
+
+# Copyright statement for this module
+Copyright = '(c) 2018 VMware. All rights reserved.'
+
+# Description of the functionality provided by this module
+Description = 'PowerShell Module for Managing Hybrid Cloud Extension (HCX) on VMware Cloud on AWS'
+
+# Minimum version of the Windows PowerShell engine required by this module
+PowerShellVersion = '6.0'
+
+# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+
+FunctionsToExport = 'Connect-HcxServer', 'Get-HcxCloudConfig', 'Get-HcxEndpoint', 'New-HcxMigration', 'Get-HcxMigration', 'Connect-HcxVAMI',
+'Get-HcxVCConfig', 'Set-HcxLicense', 'Set-HcxVCConfig', 'Get-HcxNSXConfig', 'Set-HcxNSXConfig', 'Get-HcxCity', 'Get-HcxLocation', 'Set-HcxLocation',
+'Get-HcxRoleMapping', 'Set-HcxRoleMapping', 'Get-HcxProxy', 'Set-HcxProxy', 'Remove-HcxProxy', 'Connect-HcxCloudServer', 'Get-HCXCloudActivationKey',
+'Get-HCXCloudSubscription', 'New-HCXCloudActivationKey', 'Get-HCXCloud', 'Set-HCXCloud'
+
+# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+CmdletsToExport = @()
+
+# Variables to export from this module
+VariablesToExport = '*'
+
+# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+AliasesToExport = @()
+
+# DSC resources to export from this module
+# DscResourcesToExport = @()
+
+# List of all modules packaged with this module
+# ModuleList = @()
+
+# List of all files packaged with this module
+# FileList = @()
+
+# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+PrivateData = @{
+
+    PSData = @{
+
+        # Tags applied to this module. These help with module discovery in online galleries.
+        # Tags = @()
+
+        # A URL to the license for this module.
+        # LicenseUri = ''
+
+        # A URL to the main website for this project.
+        # ProjectUri = ''
+
+        # A URL to an icon representing this module.
+        # IconUri = ''
+
+        # ReleaseNotes of this module
+        # ReleaseNotes = ''
+
+    } # End of PSData hashtable
+
+} # End of PrivateData hashtable
+
+# HelpInfo URI of this module
+# HelpInfoURI = ''
+
+# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+# DefaultCommandPrefix = ''
+
+}

Modules/VMware.Hv.Helper/Json/Farm/AutomatedLinkedCloneFarmVGPU.json

@@ -0,0 +1,97 @@
+{
+    "Type": "AUTOMATED",
+    "Data": {
+        "Name": "LCFarmJson",
+        "DisplayName": "FarmJsonTest",
+        "AccessGroup": "Root",
+        "Description": "created LC Farm from PS via JSON with NVIDIA GRID VGPU",
+        "Enabled": null,
+        "Deleting": false,
+        "Settings": {
+            "DisconnectedSessionTimeoutPolicy": "NEVER",
+            "DisconnectedSessionTimeoutMinutes": 1,
+            "EmptySessionTimeoutPolicy": "AFTER",
+            "EmptySessionTimeoutMinutes": 1,
+            "LogoffAfterTimeout": false
+        },
+        "Desktop": null,
+        "DisplayProtocolSettings": {
+            "DefaultDisplayProtocol": "PCOIP",
+            "AllowDisplayProtocolOverride": false,
+            "EnableHTMLAccess": false,
+            "EnableCollaboration": false,
+			"EnableGRIDvGPUs": true,
+			"VGPUGridProfile": "grid_m10-8a"
+        },
+        "ServerErrorThreshold": null,
+        "MirageConfigurationOverrides": {
+            "OverrideGlobalSetting": false,
+            "Enabled": false,
+            "Url": null
+        }
+    },
+    "AutomatedFarmSpec": {
+        "ProvisioningType": "VIEW_COMPOSER",
+        "VirtualCenter": null,
+        "RdsServerNamingSpec": {
+            "NamingMethod": "PATTERN",
+            "PatternNamingSettings": {
+                "NamingPattern": "LCFarmVMPS",
+                "MaxNumberOfRDSServers": 1
+            }
+        },
+        "VirtualCenterProvisioningSettings": {
+            "EnableProvisioning": true,
+            "StopProvisioningOnError": true,
+            "MinReadyVMsOnVComposerMaintenance": 0,
+            "VirtualCenterProvisioningData": {
+                "ParentVm": "RDSServer",
+                "Snapshot": "RDS_SNAP1",
+                "Datacenter": null,
+                "VmFolder": "Praveen",
+                "HostOrCluster": "CS-1",
+                "ResourcePool": "CS-1"
+            },
+            "VirtualCenterStorageSettings": {
+                "Datastores": [
+                    {
+                        "Datastore": "Datastore1",
+                        "StorageOvercommit": "UNBOUNDED"
+                    }
+                ],
+                "UseVSan": false,
+                "ViewComposerStorageSettings": {
+                    "UseSeparateDatastoresReplicaAndOSDisks": false,
+                    "ReplicaDiskDatastore": null,
+                    "UseNativeSnapshots": false,
+                    "SpaceReclamationSettings": {
+                        "ReclaimVmDiskSpace": false,
+                        "ReclamationThresholdGB": null,
+                        "BlackoutTimes": null
+                    }
+                }
+            },
+            "VirtualCenterNetworkingSettings": {
+                "Nics": null
+            }
+        },
+        "VirtualCenterManagedCommonSettings": {
+            "TransparentPageSharingScope": "VM"
+        },
+        "CustomizationSettings": {
+            "CustomizationType": "SYS_PREP",
+            "DomainAdministrator": null,
+            "AdContainer": "CN=Computers",
+            "ReusePreExistingAccounts": false,
+            "SysprepCustomizationSettings": {
+                "CustomizationSpec": "PraveenCust"
+            }
+        },
+        "RdsServerMaxSessionsData": {
+            "MaxSessionsType": "UNLIMITED",
+            "MaxSessions": null
+        }
+    },
+    "ManualFarmSpec": null,
+    "NetBiosName": "adviewdev"
+}

Modules/VMware.Hv.Helper/README.md

@@ -1,4 +1,4 @@
-Prerequisites/Steps to use this module:
+# Prerequisites/Steps to use this module
 
 1. This module only works for Horizon product E.g. Horizon 7.0.2 and later.
 2. Install the latest version of Powershell, PowerCLI(6.5) or (later version via psgallery).
@@ -6,15 +6,24 @@ Prerequisites/Steps to use this module:
 4. Import "VMware.Hv.Helper" module by running: Import-Module -Name "location of this module" or Get-Module -ListAvailable 'VMware.Hv.Helper' | Import-Module.
 5. Get-Command -Module "This module Name" to list all available functions or Get-Command -Module 'VMware.Hv.Helper'.
 
-# Example script to connect view API service of Connection Server:
+# Example script to connect ViewAPI service
 
+```
 Import-Module VMware.VimAutomation.HorizonView
+
 # Connection to view API service
 $hvServer = Connect-HVServer -server <connection server IP/FQDN>
 $hvServices = $hvserver.ExtensionData
+
+# List Connection Servers
 $csList = $hvServices.ConnectionServer.ConnectionServer_List()
+```
 # Load this module
+```
 Get-Module -ListAvailable 'VMware.Hv.Helper' | Import-Module
 Get-Command -Module 'VMware.Hv.Helper'
+```
 # Use advanced functions of this module
+```
 New-HVPool -spec 'path to InstantClone.json file'
+```

Modules/VMware.Hv.Helper/VMware.HV.Helper.psd1

@@ -12,7 +12,7 @@
 # RootModule = ''
 
 # Version number of this module.
-ModuleVersion = '1.1'
+ModuleVersion = '1.3.1'
 
 # ID used to uniquely identify this module
 GUID = '6d3f7fb5-4e52-43d8-91e1-f65f72532a1d'

Modules/VMware.Hv.Helper/docs/Add-HVDesktop.md

@@ -0,0 +1,188 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Add-HVDesktop
+
+## SYNOPSIS
+Adds virtual machine to existing pool
+
+## SYNTAX
+
+```
+Add-HVDesktop [-PoolName] <String> [-Machines] <String[]> [[-Users] <String[]>] [[-Vcenter] <String>]
+ [[-HvServer] <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+The Add-HVDesktop adds virtual machines to already exiting pools by using view API service object(hvServer) of Connect-HVServer cmdlet.
+VMs can be added to any of unmanaged manual, managed manual or Specified name.
+This advanced function do basic checks for pool and view API service connection existance, hvServer object is bound to specific connection server.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Add-HVDesktop -PoolName 'ManualPool' -Machines 'manualPool1', 'manualPool2' -Confirm:$false
+```
+
+Add managed manual VMs to existing manual pool
+
+### EXAMPLE 2
+```
+Add-HVDesktop -PoolName 'SpecificNamed' -Machines 'vm-01', 'vm-02' -Users 'user1', 'user2'
+```
+
+Add virtual machines to automated specific named dedicated pool
+
+### EXAMPLE 3
+```
+Add-HVDesktop -PoolName 'SpecificNamed' -Machines 'vm-03', 'vm-04'
+```
+
+Add machines to automated specific named Floating pool
+
+### EXAMPLE 4
+```
+Add-HVDesktop -PoolName 'Unmanaged' -Machines 'desktop-1.eng.vmware.com'
+```
+
+Add machines to unmanged manual pool
+
+## PARAMETERS
+
+### -PoolName
+Pool name to which new VMs are to be added.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Machines
+List of virtual machine names which need to be added to the given pool.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Users
+List of virtual machine users for given machines.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Vcenter
+Virtual Center server-address (IP or FQDN) of the given pool.
+This should be same as provided to the Connection Server while adding the vCenter server.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+| | |
+|-|-|
+| Author | Praveen Mathamsetty |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+| Dependencies | Make sure pool already exists before adding VMs to it. |
+
+
+### Tested Against Environment
+| | |
+|-|-|
+| Horizon View Server Version |  7.0.2, 7.1.0 |
+| PowerCLI Version |  PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version |  5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Add-HVRDSServer.md

@@ -0,0 +1,138 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Add-HVRDSServer
+
+## SYNOPSIS
+Add RDS Servers to an existing farm.
+
+## SYNTAX
+
+```
+Add-HVRDSServer [-FarmName] <Object> [-RdsServers] <String[]> [[-HvServer] <Object>] [-WhatIf] [-Confirm]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+The Add-HVRDSServer adds RDS Servers to already exiting farms by using view API service object(hvServer) of Connect-HVServer cmdlet.
+We can add RDSServers to manual farm type only.
+This advanced function do basic checks for farm and view API service connection existance.
+This hvServer is bound to specific connection server.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Add-HVRDSServer -Farm "manualFarmTest" -RdsServers "vm-for-rds","vm-for-rds-2" -Confirm:$false
+```
+
+Add RDSServers to manual farm
+
+## PARAMETERS
+
+### -FarmName
+farm name to which new RDSServers are to be added.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -RdsServers
+RDS servers names which need to be added to the given farm.
+Provide a comma separated list for multiple names.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### None
+
+## NOTES
+| | |
+|-|-|
+| Author | praveen mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+| Dependencies | Make sure farm already exists before adding RDSServers to it. |
+
+### Tested Against Environment
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Clear-HVEventDatabase.md

@@ -0,0 +1,100 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Clear-HVEventDatabase
+
+## SYNOPSIS
+Clears configurationof the configured Event Database
+
+## SYNTAX
+
+```
+Clear-HVEventDatabase [[-HvServer] <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Clears configurationof the configured Event Database
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Clear-HVEventDatabase
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.4 |
+| PowerCLI Version | PowerCLI 10 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Connect-HVEvent.md

@@ -0,0 +1,127 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Connect-HVEvent
+
+## SYNOPSIS
+This function is used to connect to the event database configured on Connection Server.
+
+## SYNTAX
+
+```
+Connect-HVEvent [[-DbPassword] <SecureString>] [[-HvServer] <Object>] [[-DbUserName] <String>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function queries the specified Connection Server for event database configuration and returns the connection object to it.
+If event database is not configured on specified connection server, it will return null.
+Currently, Horizon 7 is supporting SQL server and Oracle 12c as event database servers.
+To configure event database, goto 'Event Database Configuration' tab in Horizon admin UI.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Connect-HVEvent -HvServer $hvServer
+```
+
+Connecting to the database with default username configured on Connection Server $hvServer.
+
+### EXAMPLE 2
+```
+$hvDbServer = Connect-HVEvent -HvServer $hvServer -DbUserName 'system'
+```
+
+Connecting to the database configured on Connection Server $hvServer with customised user name 'system'.
+
+### EXAMPLE 3
+```
+$hvDbServer = Connect-HVEvent -HvServer $hvServer -DbUserName 'system' -DbPassword 'censored'
+```
+
+Connecting to the database with customised user name and password.
+
+### EXAMPLE 4
+```
+$password = Read-Host 'Database Password' -AsSecureString
+```
+
+$hvDbServer = Connect-HVEvent -HvServer $hvServer -DbUserName 'system' -DbPassword $password
+Connecting to the database with customised user name and password, with password being a SecureString.
+
+## PARAMETERS
+
+### -DbPassword
+Password corresponds to 'dbUserName' user.
+
+```yaml
+Type: SecureString
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DbUserName
+User name to be used in database connection.
+If not passed, default database user name on the Connection Server will be used.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns a custom object that has database connection as 'dbConnection' property.
+## NOTES
+| | |
+|-|-|
+| Author | Paramesh Oddepally. |
+| Author email | poddepally@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Disconnect-HVEvent.md

@@ -0,0 +1,71 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Disconnect-HVEvent
+
+## SYNOPSIS
+This function is used to disconnect the database connection.
+
+## SYNTAX
+
+```
+Disconnect-HVEvent [-HvDbServer] <PSObject> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function will disconnect the database connection made earlier during Connect-HVEvent function.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Disconnect-HVEvent -HvDbServer $hvDbServer
+```
+
+Disconnecting the database connection on $hvDbServer.
+
+## PARAMETERS
+
+### -HvDbServer
+Connection object returned by Connect-HVEvent advanced function.
+This is a mandatory input.
+
+```yaml
+Type: PSObject
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### None
+## NOTES
+| | |
+|-|-|
+| Author | Paramesh Oddepally. |
+| Author email | poddepally@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVApplication.md

@@ -0,0 +1,110 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVApplication
+
+## SYNOPSIS
+Gets the application information.
+
+## SYNTAX
+
+```
+Get-HVApplication [[-ApplicationName] <String>] [[-HvServer] <Object>] [[-FormatList] <String>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+Gets the application information.
+This will be useful to find out whether the specified application exists or not.
+If the application name is not specified, this will lists all the applications in the Pod.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVApplication -ApplicationName 'App1' -HvServer $HvServer
+```
+
+Queries and returns 'App1' information.
+
+### EXAMPLE 2
+```
+Get-HVApplication -HvServer $HvServer -FormatList:$True
+```
+
+Lists all the applications in the Pod.
+
+## PARAMETERS
+
+### -ApplicationName
+Name of the application.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -FormatList
+Displays the list of the available applications in Table Format if this parameter is set to True.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns the information of the specified application if it specified, else displays all the available applications.
+## NOTES
+| | |
+|-|-|
+| Author | Samiullasha S |
+| Author email | ssami@vmware.com |
+| Version | 1.2 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.8.0 |
+| PowerCLI Version | PowerCLI 11.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVBaseImageVM.md

@@ -0,0 +1,143 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVBaseImageVM
+
+## SYNOPSIS
+Gets a list of compatible base image virtual machines.
+
+## SYNTAX
+
+### Type (Default)
+```
+Get-HVBaseImageVM [-HvServer <Object>] [-VirtualCenter <Object>] [-Type <Object>] [<CommonParameters>]
+```
+
+### Name
+```
+Get-HVBaseImageVM [-HvServer <Object>] [-VirtualCenter <Object>] [-Name <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns BaseImageVmInfo for the specified vCenter Server.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVBaseImageVM -VirtualCenter 'vCenter1' -Type VDI
+```
+
+### EXAMPLE 2
+```
+Get-HVBaseImageVM -VirtualCenter $vCenter1 -Type ALL
+```
+
+### EXAMPLE 3
+```
+Get-HVBaseImageVM -Name '*WIN10*'
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in place of hvServer.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -VirtualCenter
+A parameter to specify which vCenter Server to check base image VMs for.
+It can be specified as a String,
+containing the name of the vCenter, or as a vCenter object as returned by Get-HVvCenterServer.
+If the value is
+not passed or null then first element returned from Get-HVvCenterServer would be considered in place of VirtualCenter.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Type
+A parameter to define the type of compatability to check the base image VM list against.
+Valid options are 'VDI', 'RDS', or 'ALL'
+'VDI' will return all desktop compatible Base Image VMs.
+'RDS' will return all RDSH compatible Base Image VMs.
+'ALL' will return all Base Image VMs, regardless of compatibility.
+The default value is 'ALL'.
+
+```yaml
+Type: Object
+Parameter Sets: Type
+Aliases:
+
+Required: False
+Position: Named
+Default value: VDI
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Name
+The name of a virtual machine (if known), to filter Base Image VMs on.
+Wildcards are accepted.
+If Name is specified, then Type
+is not considered for filtering.
+
+```yaml
+Type: String
+Parameter Sets: Name
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns array of object type VMware.Hv.BaseImageVmInfo
+## NOTES
+| | |
+|-|-|
+| Author | Matt Frey. |
+| Author email | mfrey@vmware.com |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.7 |
+| PowerCLI Version | PowerCLI 11.2.0 |
+| PowerShell Version | 5.1 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVEntitlement.md

@@ -0,0 +1,154 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVEntitlement
+
+## SYNOPSIS
+Gets association data between a user/group and a resource
+
+## SYNTAX
+
+```
+Get-HVEntitlement [[-User] <String>] [[-Type] <String>] [[-ResourceName] <String>] [[-ResourceType] <String>]
+ [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Provides entitlement Info between a single user/group and a resource that they can be assigned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVEntitlement -ResourceType Application
+```
+
+Gets all the entitlements related to application pool
+
+### EXAMPLE 2
+```
+Get-HVEntitlement -User 'adviewdev.eng.vmware.com\administrator' -ResourceName 'calculator' -ResourceType Application
+```
+
+Gets entitlements specific to user or group name and application resource
+
+### EXAMPLE 3
+```
+Get-HVEntitlement -User 'adviewdev.eng.vmware.com\administrator' -ResourceName 'UrlSetting1' -ResourceType URLRedirection
+```
+
+Gets entitlements specific to user or group and URLRedirection resource
+
+### EXAMPLE 4
+```
+Get-HVEntitlement -User 'administrator@adviewdev.eng.vmware.com' -ResourceName 'GE1' -ResourceType GlobalEntitlement
+```
+
+Gets entitlements specific to user or group and GlobalEntitlement resource
+
+## PARAMETERS
+
+### -User
+User principal name of user or group
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Type
+Whether or not this is a group or a user.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: User
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ResourceName
+The resource(Application, Desktop etc.) name.
+Supports only wildcard character '*' when resource type is desktop.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ResourceType
+Type of Resource(Application, Desktop etc.)
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: Desktop
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVEvent.md

@@ -0,0 +1,201 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVEvent
+
+## SYNOPSIS
+Queries the events from event database configured on Connection Server.
+
+## SYNTAX
+
+```
+Get-HVEvent [-HvDbServer] <PSObject> [[-TimePeriod] <String>] [[-FilterType] <String>] [[-UserFilter] <String>]
+ [[-SeverityFilter] <String>] [[-TimeFilter] <String>] [[-ModuleFilter] <String>] [[-MessageFilter] <String>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function is used to query the events information from event database.
+It returns the object that has events in five columns as UserName, Severity, EventTime, Module and Message.
+EventTime will show the exact time when the event got registered in the database and it follows timezone on database server.
+User can apply different filters on the event columns using the filter parameters userFilter, severityFilter, timeFilter, moduleFilter, messageFilter.
+Mention that when multiple filters are provided then rows which satisify all the filters will be returned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+$e = Get-HVEvent -hvDbServer $hvDbServer
+```
+
+$e.Events
+Querying all the database events on database $hvDbServer.
+
+### EXAMPLE 2
+```
+$e = Get-HVEvent -HvDbServer $hvDbServer -TimePeriod 'all' -FilterType 'startsWith' -UserFilter 'aduser' -SeverityFilter 'err' -TimeFilter 'HH:MM:SS.fff' -ModuleFilter 'broker' -MessageFilter 'aduser'
+```
+
+$e.Events | Export-Csv -Path 'myEvents.csv' -NoTypeInformation
+Querying all the database events where user name startswith 'aduser', severity is of 'err' type, having module name as 'broker', message starting with 'aduser' and time starting with 'HH:MM:SS.fff'.
+The resulting events will be exported to a csv file 'myEvents.csv'.
+
+## PARAMETERS
+
+### -HvDbServer
+Connection object returned by Connect-HVEvent advanced function.
+
+```yaml
+Type: PSObject
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -TimePeriod
+Timeperiod of the events that user is interested in.
+It can take following four values:
+   'day' - Lists last one day events from database
+   'week' - Lists last 7 days events from database
+   'month' - Lists last 30 days events from database
+   'all' - Lists all the events stored in database
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: All
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FilterType
+Type of filter action to be applied.
+The parameters userfilter, severityfilter, timefilter, modulefilter, messagefilter can be used along with this.
+It can take following values:
+   'contains' - Retrieves the events that contains the string specified in filter parameters
+   'startsWith' - Retrieves the events that starts with the string specified in filter parameters
+   'isExactly' - Retrieves the events that exactly match with the string specified in filter parameters
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: Contains
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -UserFilter
+String that can applied in filtering on 'UserName' column.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SeverityFilter
+String that can applied in filtering on 'Severity' column.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -TimeFilter
+String that can applied in filtering on 'EventTime' column.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ModuleFilter
+String that can applied in filtering on 'Module' column.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 7
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MessageFilter
+String that can applied in filtering on 'Message' column.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 8
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns a custom object that has events information in 'Events' property. Events property will have events information with five columns: UserName, Severity, EventTime, Module and Message.
+## NOTES
+| | |
+|-|-|
+| Author | Paramesh Oddepally. |
+| Author email | poddepally@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVEventDatabase.md

@@ -0,0 +1,69 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVEventDatabase
+
+## SYNOPSIS
+Retreives information about the configured Event Database
+
+## SYNTAX
+
+```
+Get-HVEventDatabase [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Collects information about the configured event database for aHorizon View pod
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVEventDatabase
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.4 |
+| PowerCLI Version | PowerCLI 10 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVFarm.md

@@ -0,0 +1,179 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVFarm
+
+## SYNOPSIS
+This function is used to find farms based on the search criteria provided by the user.
+
+## SYNTAX
+
+```
+Get-HVFarm [[-FarmName] <String>] [[-FarmDisplayName] <String>] [[-FarmType] <String>] [[-Enabled] <Boolean>]
+ [[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function queries the specified Connection Server for farms which are configured on the server.
+If no farm is configured on the specified connection server or no farm matches the given search criteria, it will return null.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVFarm -FarmName 'Farm-01'
+```
+
+Queries and returns farmInfo based on given parameter farmName
+
+### EXAMPLE 2
+```
+Get-HVFarm -FarmName 'Farm-01' -FarmDisplayName 'Sales RDS Farm'
+```
+
+Queries and returns farmInfo based on given parameters farmName, farmDisplayName
+
+### EXAMPLE 3
+```
+Get-HVFarm -FarmName 'Farm-01' -FarmType 'MANUAL'
+```
+
+Queries and returns farmInfo based on given parameters farmName, farmType
+
+### EXAMPLE 4
+```
+Get-HVFarm -FarmName 'Farm-01' -FarmType 'MANUAL' -Enabled $true
+```
+
+Queries and returns farmInfo based on given parameters farmName, FarmType etc
+
+### EXAMPLE 5
+```
+Get-HVFarm -FarmName 'Farm-0*'
+```
+
+Queries and returns farmInfo based on parameter farmName with wild character *
+
+## PARAMETERS
+
+### -FarmName
+farmName to be searched
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FarmDisplayName
+farmDisplayName to be searched
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FarmType
+farmType to be searched.
+It can take following values:
+"AUTOMATED"	- search for automated farms only
+'MANUAL' - search for manual farms only
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Enabled
+search for farms which are enabled
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no farm found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the data from.
+If the value is not passed or null then first element from global:DefaultHVServers would be considered in-place of hvServer.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns the list of FarmInfo object matching the query criteria.
+## NOTES
+| | |
+|-|-|
+| Author | praveen mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVFarmSummary.md

@@ -0,0 +1,179 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVFarmSummary
+
+## SYNOPSIS
+This function is used to find farms based on the search criteria provided by the user.
+
+## SYNTAX
+
+```
+Get-HVFarmSummary [[-FarmName] <String>] [[-FarmDisplayName] <String>] [[-FarmType] <String>]
+ [[-Enabled] <Boolean>] [[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function queries the specified Connection Server for farms which are configured on the server.
+If no farm is configured on the specified connection server or no farm matches the given search criteria, it will return null.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVFarmSummary -FarmName 'Farm-01'
+```
+
+Queries and returns farmSummary objects based on given parameter farmName
+
+### EXAMPLE 2
+```
+Get-HVFarmSummary -FarmName 'Farm-01' -FarmDisplayName 'Sales RDS Farm'
+```
+
+Queries and returns farmSummary objects based on given parameters farmName, farmDisplayName
+
+### EXAMPLE 3
+```
+Get-HVFarmSummary -FarmName 'Farm-01' -FarmType 'MANUAL'
+```
+
+Queries and returns farmSummary objects based on given parameters farmName, farmType
+
+### EXAMPLE 4
+```
+Get-HVFarmSummary -FarmName 'Farm-01' -FarmType 'MANUAL' -Enabled $true
+```
+
+Queries and returns farmSummary objects based on given parameters farmName, FarmType etc
+
+### EXAMPLE 5
+```
+Get-HVFarmSummary -FarmName 'Farm-0*'
+```
+
+Queries and returns farmSummary objects based on given parameter farmName with wild character *
+
+## PARAMETERS
+
+### -FarmName
+FarmName to be searched
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FarmDisplayName
+FarmDisplayName to be searched
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FarmType
+FarmType to be searched.
+It can take following values:
+"AUTOMATED"	- search for automated farms only
+'MANUAL' - search for manual farms only
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Enabled
+Search for farms which are enabled
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no farm found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the data from.
+If the value is not passed or null then first element from global:DefaultHVServers would be considered in-place of hvServer.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns the list of FarmSummary object matching the query criteria.
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVGlobalEntitlement.md

@@ -0,0 +1,118 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVGlobalEntitlement
+
+## SYNOPSIS
+Gets Global Entitlement(s) with given search parameters.
+
+## SYNTAX
+
+```
+Get-HVGlobalEntitlement [[-DisplayName] <String>] [[-Description] <String>] [[-SuppressInfo] <Boolean>]
+ [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns global entitlement(s) and global application entitlement(s).
+Global entitlements are used to route users to their resources across multiple pods.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVGlobalEntitlement -DisplayName 'GEAPP'
+```
+
+Retrieves global application/desktop entitlement(s) with displayName 'GEAPP'
+
+## PARAMETERS
+
+### -DisplayName
+Display Name of Global Entitlement.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Description
+Description of Global Entitlement.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no global entitlement(s) found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVGlobalSession.md

@@ -0,0 +1,69 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVGlobalSession
+
+## SYNOPSIS
+Provides a list with all Global sessions in a Cloud Pod Architecture
+
+## SYNTAX
+
+```
+Get-HVGlobalSession [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+The get-hvglobalsession gets all local session by using view API service object(hvServer) of Connect-HVServer cmdlet.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-hvglobalsession
+```
+
+Gets all global sessions
+
+## PARAMETERS
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten. |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0, 7.3.2 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVGlobalSettings.md

@@ -0,0 +1,70 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVGlobalSettings
+
+## SYNOPSIS
+Gets a list of Global Settings
+
+## SYNTAX
+
+```
+Get-HVGlobalSettings [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns the Global Settings for the pod of the specified HVServer.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVGlobalSettings
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered inplace of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns list of object type VMware.Hv.GlobalSettingsInfo
+## NOTES
+| | |
+|-|-|
+| Author | Matt Frey. |
+| Author email | mfrey@vmware.com |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.1 |
+| PowerCLI Version | PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVHealth.md

@@ -0,0 +1,95 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVHealth
+
+## SYNOPSIS
+Pulls health information from Horizon View
+
+## SYNTAX
+
+```
+Get-HVHealth [[-Servicename] <String>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns health information from the local Horizon Pod
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVHealth -service connectionserver
+```
+
+Returns health for the connectionserver(s)
+
+### EXAMPLE 2
+```
+Get-HVHealth -service ViewComposer
+```
+
+Returns health for the View composer server(s)
+
+## PARAMETERS
+
+### -Servicename
+The name of the service to query the health for.
+ This will default to Connection server health.
+ Available services are ADDomain,CertificateSSOConnector,ConnectionServer,EventDatabase,SAMLAuthenticator,SecurityServer,ViewComposer,VirtualCenter,Pod
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: ConnectionServer
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.3.2,7.4 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVHomeSite.md

@@ -0,0 +1,89 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVHomeSite
+
+## SYNOPSIS
+Gets the configured Horizon View Homesites
+
+## SYNTAX
+
+```
+Get-HVHomeSite [[-Group] <String>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Gets the configured Horizon View Homesites
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVHomeSite
+```
+
+### EXAMPLE 2
+```
+Get-HVHomeSite -group group@domain
+```
+
+## PARAMETERS
+
+### -Group
+User principal name of a group
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.4 |
+| PowerCLI Version | PowerCLI 10 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVInternalName.md

@@ -0,0 +1,120 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVInternalName
+
+## SYNOPSIS
+Gets human readable name
+
+## SYNTAX
+
+```
+Get-HVInternalName [-EntityId] <EntityId> [[-VcId] <VirtualCenterId>] [[-BaseImageVmId] <BaseImageVmId>]
+ [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Converts Horizon API Ids to human readable names.
+Horizon API Ids are base64 encoded, this function
+will decode and returns internal/human readable names.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVInternalName -EntityId $entityId
+```
+
+Decodes Horizon API Id and returns human readable name
+
+## PARAMETERS
+
+### -EntityId
+Representation of a manageable entity id.
+
+```yaml
+Type: EntityId
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -VcId
+{{ Fill VcId Description }}
+
+```yaml
+Type: VirtualCenterId
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -BaseImageVmId
+{{ Fill BaseImageVmId Description }}
+
+```yaml
+Type: BaseImageVmId
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns human readable name
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVLocalSession.md

@@ -0,0 +1,69 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVLocalSession
+
+## SYNOPSIS
+Provides a list with all sessions on the local pod (works in CPA and non-CPA)
+
+## SYNTAX
+
+```
+Get-HVLocalSession [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+The Get-HVLocalSession gets all local session by using view API service object(hvServer) of Connect-HVServer cmdlet.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVLocalSession
+```
+
+Get all local sessions
+
+## PARAMETERS
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+Author                      : Wouter Kursten.
+Author email                : wouter@retouw.nl
+Version                     : 1.0
+
+===Tested Against Environment====
+| | |
+|-|-|
+Horizon View Server Version : 7.0.2, 7.1.0, 7.3.2
+PowerCLI Version            : PowerCLI 6.5, PowerCLI 6.5.1
+PowerShell Version          : 5.0
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVMachine.md

@@ -0,0 +1,180 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVMachine
+
+## SYNOPSIS
+Gets virtual Machine(s) information with given search parameters.
+
+## SYNTAX
+
+```
+Get-HVMachine [[-PoolName] <String>] [[-MachineName] <String>] [[-DnsName] <String>] [[-State] <String>]
+ [[-JsonFilePath] <String>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns virtual machines information, the machines list would be determined
+based on queryable fields poolName, dnsName, machineName, state.
+When more than one
+fields are used for query the virtual machines which satisfy all fields criteria would be returned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVMachine -PoolName 'ManualPool'
+```
+
+Queries VM(s) with given parameter poolName
+
+### EXAMPLE 2
+```
+Get-HVMachine -MachineName 'PowerCLIVM'
+```
+
+Queries VM(s) with given parameter machineName
+
+### EXAMPLE 3
+```
+Get-HVMachine -State CUSTOMIZING
+```
+
+Queries VM(s) with given parameter vm state
+
+### EXAMPLE 4
+```
+Get-HVMachine -DnsName 'powercli-*'
+```
+
+Queries VM(s) with given parameter dnsName with wildcard character *
+
+## PARAMETERS
+
+### -PoolName
+Pool name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MachineName
+The name of the Machine to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DnsName
+DNS name for the Machine to filter with.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -State
+The basic state of the Machine to filter with.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -JsonFilePath
+{{ Fill JsonFilePath Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns list of objects of type MachineInfo
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVMachineSummary.md

@@ -0,0 +1,195 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVMachineSummary
+
+## SYNOPSIS
+Gets virtual Machine(s) summary with given search parameters.
+
+## SYNTAX
+
+```
+Get-HVMachineSummary [[-PoolName] <String>] [[-MachineName] <String>] [[-DnsName] <String>] [[-State] <String>]
+ [[-JsonFilePath] <String>] [[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns virtual machines information, the machines list would be determined
+based on queryable fields poolName, dnsName, machineName, state.
+When more than one
+fields are used for query the virtual machines which satisfy all fields criteria would be returned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVMachineSummary -PoolName 'ManualPool'
+```
+
+Queries VM(s) with given parameter poolName
+
+### EXAMPLE 2
+```
+Get-HVMachineSummary -MachineName 'PowerCLIVM'
+```
+
+Queries VM(s) with given parameter machineName
+
+### EXAMPLE 3
+```
+Get-HVMachineSummary -State CUSTOMIZING
+```
+
+Queries VM(s) with given parameter vm state
+
+### EXAMPLE 4
+```
+Get-HVMachineSummary -DnsName 'powercli-*'
+```
+
+Queries VM(s) with given parameter dnsName with wildcard character *
+
+## PARAMETERS
+
+### -PoolName
+Pool name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MachineName
+The name of the Machine to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DnsName
+DNS name for the Machine to filter with.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -State
+The basic state of the Machine to filter with.
+If the value is null or not provided then filter will not be applied,
+otherwise the virtual machines which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -JsonFilePath
+{{ Fill JsonFilePath Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no machine found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 7
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns list of objects of type MachineNamesView
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVPodFederation.md

@@ -0,0 +1,71 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVPodFederation
+
+## SYNOPSIS
+Returns information about a Horizon View Pod Federation (Cloud Pod Architecture)
+
+## SYNTAX
+
+```
+Get-HVPodFederation [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Returns information about a Horizon View Pod Federation (Cloud Pod Architecture)
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVPodFederation
+```
+
+Returns information about a Horizon View Pod Federation
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.3.2,7.4 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVPool.md

@@ -0,0 +1,218 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVPool
+
+## SYNOPSIS
+Gets pool(s) information with given search parameters.
+
+## SYNTAX
+
+```
+Get-HVPool [[-PoolName] <String>] [[-PoolDisplayName] <String>] [[-PoolType] <String>]
+ [[-UserAssignment] <String>] [[-Enabled] <Boolean>] [[-ProvisioningEnabled] <Boolean>]
+ [[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns pools information, the pools list would be determined based on
+queryable fields poolName, poolDisplayName, poolType, userAssignment, enabled,
+provisioningEnabled.
+When more than one fields are used for query the pools which
+satisfy all fields criteria would be returned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVPool -PoolName 'mypool' -PoolType MANUAL -UserAssignment FLOATING -Enabled $true -ProvisioningEnabled $true
+```
+
+Queries and returns pool object(s) based on given parameters poolName, poolType etc.
+
+### EXAMPLE 2
+```
+Get-HVPool -PoolType AUTOMATED -UserAssignment FLOATING
+```
+
+Queries and returns pool object(s) based on given parameters poolType and userAssignment
+
+### EXAMPLE 3
+```
+Get-HVPool -PoolName 'myrds' -PoolType RDS -UserAssignment DEDICATED -Enabled $false
+```
+
+Queries and returns pool object(s) based on given parameters poolName, PoolType etc.
+
+### EXAMPLE 4
+```
+Get-HVPool -PoolName 'myrds' -PoolType RDS -UserAssignment DEDICATED -Enabled $false -HvServer $mycs
+```
+
+Queries and returns pool object(s) based on given parameters poolName and HvServer etc.
+
+## PARAMETERS
+
+### -PoolName
+Pool name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the pools which has name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PoolDisplayName
+Pool display name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the pools which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PoolType
+Pool type to filter with.
+If the value is null or not provided then filter will not be applied.
+If the value is MANUAL then only manual pools would be returned.
+If the value is AUTOMATED then only automated pools would be returned
+If the value is RDS then only Remote Desktop Service Pool pools would be returned
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -UserAssignment
+User Assignment of pool to filter with.
+If the value is null or not provided then filter will not be applied.
+If the value is DEDICATED then only dedicated pools would be returned.
+If the value is FLOATING then only floating pools would be returned
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Enabled
+Pool enablement to filter with.
+If the value is not provided then then filter will not be applied.
+If the value is true then only pools which are enabled would be returned.
+If the value is false then only pools which are disabled would be returned.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ProvisioningEnabled
+{{ Fill ProvisioningEnabled Description }}
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no pool found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 7
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the pools from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 8
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns list of objects of type DesktopInfo
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVPoolSpec.md

@@ -0,0 +1,142 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVPoolSpec
+
+## SYNOPSIS
+Gets desktop specification
+
+## SYNTAX
+
+```
+Get-HVPoolSpec [-DesktopInfo] <DesktopInfo> [[-FilePath] <String>] [[-HvServer] <Object>] [-WhatIf] [-Confirm]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+Converts DesktopInfo Object to DesktopSpec.
+Also Converts view API Ids to human readable names
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVPoolSpec -DesktopInfo $DesktopInfoObj
+```
+
+Converts DesktopInfo to DesktopSpec
+
+### EXAMPLE 2
+```
+Get-HVPool -PoolName 'LnkClnJson' | Get-HVPoolSpec -FilePath "C:\temp\LnkClnJson.json"
+```
+
+Converts DesktopInfo to DesktopSpec and also dumps json object
+
+## PARAMETERS
+
+### -DesktopInfo
+An object with detailed description of a desktop instance.
+
+```yaml
+Type: DesktopInfo
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -FilePath
+{{ Fill FilePath Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns desktop specification
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVPoolSummary.md

@@ -0,0 +1,218 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVPoolSummary
+
+## SYNOPSIS
+Gets pool summary with given search parameters.
+
+## SYNTAX
+
+```
+Get-HVPoolSummary [[-PoolName] <String>] [[-PoolDisplayName] <String>] [[-PoolType] <String>]
+ [[-UserAssignment] <String>] [[-Enabled] <Boolean>] [[-ProvisioningEnabled] <Boolean>]
+ [[-SuppressInfo] <Boolean>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns pools information, the pools list would be determined based on
+queryable fields poolName, poolDisplayName, poolType, userAssignment, enabled,
+provisioningEnabled.
+When more than one fields are used for query the pools which
+satisfy all fields criteria would be returned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVPoolSummary -PoolName 'mypool' -PoolType MANUAL -UserAssignment FLOATING -Enabled $true -ProvisioningEnabled $true
+```
+
+Queries and returns desktopSummaryView based on given parameters poolName, poolType etc.
+
+### EXAMPLE 2
+```
+Get-HVPoolSummary -PoolType AUTOMATED -UserAssignment FLOATING
+```
+
+Queries and returns desktopSummaryView based on given parameters poolType, userAssignment.
+
+### EXAMPLE 3
+```
+Get-HVPoolSummary -PoolName 'myrds' -PoolType RDS -UserAssignment DEDICATED -Enabled $false
+```
+
+Queries and returns desktopSummaryView based on given parameters poolName, poolType, userAssignment etc.
+
+### EXAMPLE 4
+```
+Get-HVPoolSummary -PoolName 'myrds' -PoolType RDS -UserAssignment DEDICATED -Enabled $false -HvServer $mycs
+```
+
+Queries and returns desktopSummaryView based on given parameters poolName, HvServer etc.
+
+## PARAMETERS
+
+### -PoolName
+Pool name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the pools which has name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PoolDisplayName
+Pool display name to query for.
+If the value is null or not provided then filter will not be applied,
+otherwise the pools which has display name same as value will be returned.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PoolType
+Pool type to filter with.
+If the value is null or not provided then filter will not be applied.
+If the value is MANUAL then only manual pools would be returned.
+If the value is AUTOMATED then only automated pools would be returned
+If the value is RDS then only Remote Desktop Service Pool pools would be returned
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -UserAssignment
+User Assignment of pool to filter with.
+If the value is null or not provided then filter will not be applied.
+If the value is DEDICATED then only dedicated pools would be returned.
+If the value is FLOATING then only floating pools would be returned
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Enabled
+Pool enablement to filter with.
+If the value is not provided then then filter will not be applied.
+If the value is true then only pools which are enabled would be returned.
+If the value is false then only pools which are disabled would be returned.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ProvisioningEnabled
+{{ Fill ProvisioningEnabled Description }}
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SuppressInfo
+Suppress text info, when no pool found with given search parameters
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 7
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the pools from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 8
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns list of DesktopSummaryView
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVPreInstalledApplication.md

@@ -0,0 +1,85 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVPreInstalledApplication
+
+## SYNOPSIS
+Gets the list of Pre-installed Applications from the RDS Server(s).
+
+## SYNTAX
+
+```
+Get-HVPreInstalledApplication [-FarmName] <String> [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Gets the list of Pre-installed Applications from the RDS Server(s).
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVPreInstalledApplication -FarmName 'Farm1' -HvServer $HvServer
+```
+
+Gets the list of Applications present in 'Farm1', if exists.
+
+## PARAMETERS
+
+### -FarmName
+Name of the Farm on which to discover installed applications.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -HvServer
+View API service object of Connect-HVServer cmdlet.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Gets the list of Applications from the specified Farm if exists.
+## NOTES
+| | |
+|-|-|
+| Author | Samiullasha S |
+| Author email | ssami@vmware.com |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.8.0 |
+| PowerCLI Version | PowerCLI 11.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVQueryFilter.md

@@ -0,0 +1,308 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVQueryFilter
+
+## SYNOPSIS
+Creates a VMware.Hv.QueryFilter based on input provided.
+
+## SYNTAX
+
+### ne
+```
+Get-HVQueryFilter [-MemberName] <String> [-Ne] [-MemberValue] <Object> [<CommonParameters>]
+```
+
+### startswith
+```
+Get-HVQueryFilter [-MemberName] <String> [-Startswith] [-MemberValue] <Object> [<CommonParameters>]
+```
+
+### contains
+```
+Get-HVQueryFilter [-MemberName] <String> [-Contains] [-MemberValue] <Object> [<CommonParameters>]
+```
+
+### eq
+```
+Get-HVQueryFilter [-MemberName] <String> [-Eq] [-MemberValue] <Object> [<CommonParameters>]
+```
+
+### not
+```
+Get-HVQueryFilter [-Not] [-Filter] <QueryFilter> [<CommonParameters>]
+```
+
+### and
+```
+Get-HVQueryFilter [-And] [-Filters] <QueryFilter[]> [<CommonParameters>]
+```
+
+### or
+```
+Get-HVQueryFilter [-Or] [-Filters] <QueryFilter[]> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This is a factory method to create a VMware.Hv.QueryFilter.
+The type of the QueryFilter would be determined based on switch used.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVQueryFilter data.name -Eq vmware
+```
+
+Creates queryFilterEquals with given parameters memberName(position 0) and memberValue(position 2)
+
+### EXAMPLE 2
+```
+Get-HVQueryFilter -MemberName data.name -Eq -MemberValue vmware
+```
+
+Creates queryFilterEquals with given parameters memberName and memberValue
+
+### EXAMPLE 3
+```
+Get-HVQueryFilter data.name -Ne vmware
+```
+
+Creates queryFilterNotEquals filter with given parameters memberName and memberValue
+
+### EXAMPLE 4
+```
+Get-HVQueryFilter data.name -Contains vmware
+```
+
+Creates queryFilterContains with given parameters memberName and memberValue
+
+### EXAMPLE 5
+```
+Get-HVQueryFilter data.name -Startswith vmware
+```
+
+Creates queryFilterStartsWith with given parameters memberName and memberValue
+
+### EXAMPLE 6
+```
+$filter = Get-HVQueryFilter data.name -Startswith vmware
+```
+
+Get-HVQueryFilter -Not $filter
+Creates queryFilterNot with given parameter filter
+
+### EXAMPLE 7
+```
+$filter1 = Get-HVQueryFilter data.name -Startswith vmware
+```
+
+$filter2 = Get-HVQueryFilter data.name -Contains pool
+Get-HVQueryFilter -And @($filter1, $filter2)
+
+Creates queryFilterAnd with given parameter filters array
+
+### EXAMPLE 8
+```
+$filter1 = Get-HVQueryFilter data.name -Startswith vmware
+```
+
+$filter2 = Get-HVQueryFilter data.name -Contains pool
+Get-HVQueryFilter -Or @($filter1, $filter2)
+Creates queryFilterOr with given parameter filters array
+
+## PARAMETERS
+
+### -MemberName
+Property path separated by .
+(dot) from the root of queryable data object which is being queried for
+
+```yaml
+Type: String
+Parameter Sets: ne, startswith, contains, eq
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Eq
+Switch to create QueryFilterEquals filter
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: eq
+Aliases:
+
+Required: True
+Position: 2
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Contains
+Switch to create QueryFilterContains filter
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: contains
+Aliases:
+
+Required: True
+Position: 2
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Startswith
+Switch to create QueryFilterStartsWith filter
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: startswith
+Aliases:
+
+Required: True
+Position: 2
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Ne
+Switch to create QueryFilterNotEquals filter
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: ne
+Aliases:
+
+Required: True
+Position: 2
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MemberValue
+Value of property (memberName) which is used for filtering
+
+```yaml
+Type: Object
+Parameter Sets: ne, startswith, contains, eq
+Aliases:
+
+Required: True
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Not
+Switch to create QueryFilterNot filter, used for negating existing filter
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: not
+Aliases:
+
+Required: True
+Position: 1
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Filter
+Filter to used in QueryFilterNot to negate the result
+
+```yaml
+Type: QueryFilter
+Parameter Sets: not
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -And
+Switch to create QueryFilterAnd filter, used for joing two or more filters
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: and
+Aliases:
+
+Required: True
+Position: 1
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Or
+Switch to create QueryFilterOr filter, used for joing two or more filters
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: or
+Aliases:
+
+Required: True
+Position: 1
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Filters
+List of filters to join using QueryFilterAnd or QueryFilterOr
+
+```yaml
+Type: QueryFilter[]
+Parameter Sets: and, or
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns the QueryFilter object
+## NOTES
+| | |
+|-|-|
+| Author | Kummara Ramamohan. |
+| Author email | kramamohan@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVQueryResult.md

@@ -0,0 +1,181 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVQueryResult
+
+## SYNOPSIS
+Returns the query results from ViewApi Query Service
+
+## SYNTAX
+
+```
+Get-HVQueryResult [-EntityType] <String> [[-Filter] <QueryFilter>] [[-SortBy] <String>]
+ [[-SortDescending] <Boolean>] [[-Limit] <Int16>] [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Get-HVQueryResult is a API to query the results using ViewApi.
+The filtering of the returned
+list would be done based on input parameters filter, sortDescending, sortyBy, limit
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVQueryResult DesktopSummaryView
+```
+
+Returns query results of entityType DesktopSummaryView(position 0)
+
+### EXAMPLE 2
+```
+Get-HVQueryResult DesktopSummaryView (Get-HVQueryFilter data.name -Eq vmware)
+```
+
+Returns query results of entityType DesktopSummaryView(position 0) with given filter(position 1)
+
+### EXAMPLE 3
+```
+Get-HVQueryResult -EntityType DesktopSummaryView -Filter (Get-HVQueryFilter desktopSummaryData.name -Eq vmware)
+```
+
+Returns query results of entityType DesktopSummaryView with given filter
+
+### EXAMPLE 4
+```
+$myFilter = Get-HVQueryFilter data.name -Contains vmware
+```
+
+Get-HVQueryResult -EntityType DesktopSummaryView -Filter $myFilter -SortBy desktopSummaryData.displayName -SortDescending $false
+Returns query results of entityType DesktopSummaryView with given filter and also sorted based on dispalyName
+
+### EXAMPLE 5
+```
+Get-HVQueryResult DesktopSummaryView -Limit 10
+```
+
+Returns query results of entityType DesktopSummaryView, maximum count equal to limit
+
+## PARAMETERS
+
+### -EntityType
+ViewApi Queryable entity type which is being queried for.The return list would be containing objects of entityType
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Filter
+Filter to used for filtering the results, See Get-HVQueryFilter for more information
+
+```yaml
+Type: QueryFilter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SortBy
+Data field path used for sorting the results
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SortDescending
+If the value is set to true (default) then the results will be sorted in descending order
+If the value is set to false then the results will be sorted in ascending order
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: True
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Limit
+Max number of objects to retrieve.
+Default would be 0 which means retieve all the results
+
+```yaml
+Type: Int16
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: 0
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the data from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns the list of objects of entityType
+## NOTES
+| | |
+|-|-|
+| Author | Kummara Ramamohan. |
+| Author email | kramamohan@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0,7.4 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1, PowerCLI 10.1.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVResourceStructure.md

@@ -0,0 +1,70 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVResourceStructure
+
+## SYNOPSIS
+Output the structure of the resource pools available to a HV. 
+Primarily this is for debugging
+
+PS\> Get-HVResourceStructure
+vCenter vc.domain.local
+Container DC path /DC/host
+HostOrCluster Servers path /DC/host/Servers
+HostOrCluster VDI path /DC/host/VDI
+ResourcePool Servers path /DC/host/Servers/Resources
+ResourcePool VDI path /DC/host/VDI/Resources
+ResourcePool RP1 path /DC/host/VDI/Resources/RP1
+ResourcePool RP2 path /DC/host/VDI/Resources/RP1/RP2
+
+| Author | Mark Elvers \<mark.elvers@tunbury.org\> |
+
+## SYNTAX
+
+```
+Get-HVResourceStructure [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+{{ Fill in the Description }}
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> {{ Add example code here }}
+```
+
+{{ Add example description here }}
+
+## PARAMETERS
+
+### -HvServer
+{{ Fill HvServer Description }}
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVSite.md

@@ -0,0 +1,71 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVSite
+
+## SYNOPSIS
+Returns information about the sites within a Horizon View Pod Federation (Cloud Pod Architecture)
+
+## SYNTAX
+
+```
+Get-HVSite [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Returns information about the sites within a Horizon View Pod Federation (Cloud Pod Architecture)
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+get-hvsite
+```
+
+Returns information about the sites within a Horizon View Pod Federation.
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.3.2,7.4 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVlicense.md

@@ -0,0 +1,69 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVlicense
+
+## SYNOPSIS
+Gets the license for Horizon View
+
+## SYNTAX
+
+```
+Get-HVlicense [[-HvServer] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Gets the license for Horizon View
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+get-hvlicense
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.4,7.5 |
+| PowerCLI Version | PowerCLI 10 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVvCenterServer.md

@@ -0,0 +1,90 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVvCenterServer
+
+## SYNOPSIS
+Gets a list of all configured vCenter Servers
+
+## SYNTAX
+
+```
+Get-HVvCenterServer [[-HvServer] <Object>] [[-Name] <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns the vCenter Servers configured for the pod of the specified HVServer.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVvCenterServer
+```
+
+### EXAMPLE 2
+```
+Get-HVvCenterServer -Name 'vCenter1'
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered inplace of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Name
+A string value to query a vCenter Server by Name, if it is known.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns array of object type VMware.Hv.VirtualCenterInfo
+## NOTES
+| | |
+|-|-|
+| Author | Matt Frey. |
+| Author email | mfrey@vmware.com |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.7 |
+| PowerCLI Version | PowerCLI 11.2.0 |
+| PowerShell Version | 5.1 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/Get-HVvCenterServerHealth.md

@@ -0,0 +1,97 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# Get-HVvCenterServerHealth
+
+## SYNOPSIS
+Gets a the health info for a given vCenter Server.
+
+## SYNTAX
+
+```
+Get-HVvCenterServerHealth [[-HvServer] <Object>] [[-VirtualCenter] <Object>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Queries and returns the VirtualCenterHealthInfo specified HVServer.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Get-HVvCenterServerHealth -VirtualCenter 'vCenter1'
+```
+
+### EXAMPLE 2
+```
+Get-HVvCenterServerHealth -VirtualCenter $vCenter1
+```
+
+### EXAMPLE 3
+```
+Get-HVvCenterServerHealth
+```
+
+## PARAMETERS
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered inplace of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -VirtualCenter
+A parameter to specify which vCenter Server to check health for.
+If not specified, this function will return the
+health info for all vCenter Servers.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Returns array of object type VMware.Hv.VirtualCenterInfo
+## NOTES
+| | |
+|-|-|
+| Author | Matt Frey. |
+| Author email | mfrey@vmware.com |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.7 |
+| PowerCLI Version | PowerCLI 11.2.0 |
+| PowerShell Version | 5.1 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/New-HVEntitlement.md

@@ -0,0 +1,221 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# New-HVEntitlement
+
+## SYNOPSIS
+Associates a user/group with a resource
+
+## SYNTAX
+
+### Default
+```
+New-HVEntitlement -User <String> -ResourceName <String> [-ResourceType <String>] [-Type <String>]
+ [-HvServer <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+### PipeLine
+```
+New-HVEntitlement -User <String> -Resource <Object> [-ResourceType <String>] [-Type <String>]
+ [-HvServer <Object>] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This represents a simple association between a single user/group and a resource that they can be assigned.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+New-HVEntitlement  -User 'administrator@adviewdev.eng.vmware.com' -ResourceName 'InsClnPol' -Confirm:$false
+```
+
+Associate a user/group with a pool
+
+### EXAMPLE 2
+```
+New-HVEntitlement  -User 'adviewdev\administrator' -ResourceName 'Calculator' -ResourceType Application
+```
+
+Associate a user/group with a application
+
+### EXAMPLE 3
+```
+New-HVEntitlement  -User 'adviewdev.eng.vmware.com\administrator' -ResourceName 'UrlSetting1' -ResourceType URLRedirection
+```
+
+Associate a user/group with a URLRedirection settings
+
+### EXAMPLE 4
+```
+New-HVEntitlement  -User 'adviewdev.eng.vmware.com\administrator' -ResourceName 'GE1' -ResourceType GlobalEntitlement
+```
+
+Associate a user/group with a desktop entitlement
+
+### EXAMPLE 5
+```
+New-HVEntitlement  -User 'adviewdev\administrator' -ResourceName 'GEAPP1' -ResourceType GlobalApplicationEntitlement
+```
+
+Associate a user/group with a application entitlement
+
+### EXAMPLE 6
+```
+$pools = Get-HVPool; $pools | New-HVEntitlement  -User 'adviewdev\administrator' -Confirm:$false
+```
+
+Associate a user/group with list of pools
+
+## PARAMETERS
+
+### -User
+User principal name of user or group
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ResourceName
+The resource(Application, Desktop etc.) name.
+Supports only wildcard character '*' when resource type is desktop.
+
+```yaml
+Type: String
+Parameter Sets: Default
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Resource
+Object(s) of the resource(Application, Desktop etc.) to entitle
+
+```yaml
+Type: Object
+Parameter Sets: PipeLine
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: True (ByValue)
+Accept wildcard characters: False
+```
+
+### -ResourceType
+Type of Resource(Application, Desktop etc)
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: Desktop
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Type
+Whether or not this is a group or a user.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: User
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/New-HVGlobalEntitlement.md

@@ -0,0 +1,329 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# New-HVGlobalEntitlement
+
+## SYNOPSIS
+Creates a Global Entitlement.
+
+## SYNTAX
+
+```
+New-HVGlobalEntitlement [-DisplayName] <String> [-Type] <String> [[-Description] <String>] [[-Scope] <String>]
+ [[-Dedicated] <Boolean>] [[-FromHome] <Boolean>] [[-RequireHomeSite] <Boolean>]
+ [[-MultipleSessionAutoClean] <Boolean>] [[-Enabled] <Boolean>] [[-SupportedDisplayProtocols] <String[]>]
+ [[-DefaultDisplayProtocol] <String>] [[-AllowUsersToChooseProtocol] <Boolean>]
+ [[-AllowUsersToResetMachines] <Boolean>] [[-EnableHTMLAccess] <Boolean>] [[-HvServer] <Object>] [-WhatIf]
+ [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Global entitlements are used to route users to their resources across multiple pods.
+These are persisted in a global ldap instance that is replicated across all pods in a linked mode view set.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+New-HVGlobalEntitlement -DisplayName 'GE_APP' -Type APPLICATION_ENTITLEMENT
+```
+
+Creates new global application entitlement
+
+### EXAMPLE 2
+```
+New-HVGlobalEntitlement -DisplayName 'GE_DESKTOP' -Type DESKTOP_ENTITLEMENT
+```
+
+Creates new global desktop entitlement
+
+## PARAMETERS
+
+### -DisplayName
+Display Name of Global Entitlement.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Type
+Specify whether to create desktop/app global entitlement
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Description
+Description of Global Entitlement.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Scope
+Scope for this global entitlement.
+Visibility and Placement policies are defined by this value.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: ANY
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Dedicated
+Specifies whether dedicated/floating resources associated with this global entitlement.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 5
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FromHome
+This value defines the starting location for resource placement and search.
+When true, a pod in the user's home site is used to start the search.
+When false, the current site is used.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 6
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -RequireHomeSite
+This value determines whether we fail if a home site isn't defined for this global entitlement.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 7
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -MultipleSessionAutoClean
+This value is used to determine if automatic session clean up is enabled.
+This cannot be enabled when this Global Entitlement is associated with a Desktop that has dedicated user assignment.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 8
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Enabled
+If this Global Entitlement is enabled.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 9
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SupportedDisplayProtocols
+The set of supported display protocols for the global entitlement.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 10
+Default value: @("PCOIP","BLAST")
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -DefaultDisplayProtocol
+The default display protocol for the global entitlement.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 11
+Default value: PCOIP
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AllowUsersToChooseProtocol
+Whether the users can choose the protocol used.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 12
+Default value: True
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AllowUsersToResetMachines
+Whether users are allowed to reset/restart their machines.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 13
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -EnableHTMLAccess
+If set to true, the desktops that are associated with this GlobalEntitlement must also have HTML Access enabled.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 14
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 15
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -WhatIf
+Shows what would happen if the cmdlet runs.
+The cmdlet is not run.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: wi
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Confirm
+Prompts you for confirmation before running the cmdlet.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases: cf
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Praveen Mathamsetty. |
+| Author email | pmathamsetty@vmware.com |
+| Version | 1.1 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.0.2, 7.1.0 |
+| PowerCLI Version | PowerCLI 6.5, PowerCLI 6.5.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS

Modules/VMware.Hv.Helper/docs/New-HVHomeSite.md

@@ -0,0 +1,178 @@
+---
+external help file: VMware.HV.Helper-help.xml
+Module Name: VMware.HV.Helper
+online version:
+schema: 2.0.0
+---
+
+# New-HVHomeSite
+
+## SYNOPSIS
+Defines a homesite within a Horizon View Cloud Pod architecture
+
+## SYNTAX
+
+### Default (Default)
+```
+New-HVHomeSite -Group <String> -Site <String> [-HvServer <Object>] [<CommonParameters>]
+```
+
+### globalApplicationEntitlement
+```
+New-HVHomeSite [-Group <String>] [-Site <String>] [-globalApplicationEntitlement <String>] [-HvServer <Object>]
+ [<CommonParameters>]
+```
+
+### globalEntitlement
+```
+New-HVHomeSite [-Group <String>] [-Site <String>] [-globalEntitlement <String>] [-HvServer <Object>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+Creates a new homesite within a Cloud Pod Archtitecture.
+By default it will be applied to everything 
+but the choice can be made to only apply for a single global entitlement or singel global application entitlement
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+New-HVHomeSite -group group@domain -site SITE
+```
+
+### EXAMPLE 2
+```
+New-HVHomeSite -group group@domain -site SITE -globalapplicationentitlement ge-ap01
+```
+
+### EXAMPLE 3
+```
+New-HVHomeSite -group group@domain -site SITE -globalentitlement GE_Production
+```
+
+## PARAMETERS
+
+### -Group
+User principal name of a group
+
+```yaml
+Type: String
+Parameter Sets: Default
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+```yaml
+Type: String
+Parameter Sets: globalApplicationEntitlement, globalEntitlement
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Site
+Name of the Horizon View Site
+
+```yaml
+Type: String
+Parameter Sets: Default
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+```yaml
+Type: String
+Parameter Sets: globalApplicationEntitlement, globalEntitlement
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -globalEntitlement
+Name of the global entitlement
+
+```yaml
+Type: String
+Parameter Sets: globalEntitlement
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -globalApplicationEntitlement
+Name of the global application entitlement
+
+```yaml
+Type: String
+Parameter Sets: globalApplicationEntitlement
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -HvServer
+Reference to Horizon View Server to query the virtual machines from.
+If the value is not passed or null then
+first element from global:DefaultHVServers would be considered in-place of hvServer
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+| | |
+|-|-|
+| Author | Wouter Kursten |
+| Author email | wouter@retouw.nl |
+| Version | 1.0 |
+
+===Tested Against Environment====
+| | |
+|-|-|
+| Horizon View Server Version | 7.4 |
+| PowerCLI Version | PowerCLI 10.1.1 |
+| PowerShell Version | 5.0 |
+
+## RELATED LINKS