Final release

.github/ISSUE_TEMPLATE/bug.yml

@@ -32,7 +32,10 @@ body:
     id: version-vcf
     attributes:
       label: VMware Cloud Foundation
-      description: Please provide the VMware Cloud Foundation version.
+      description: >
+        Please provide the VMware Cloud Foundation version.
+
+        For details on specific VMware Cloud Foundation versions supported by this module, please refer to the [documentation](https://vmware.github.io/powershell-module-for-vmware-cloud-foundation/).
     validations:
       required: true
   - type: input

.github/labeler-pull-requests.yml

@@ -0,0 +1,22 @@
+---
+chore:
+  - changed-files:
+      - any-glob-to-any-file:
+          - ".ci/**/*"
+          - ".github/**/*"
+          - ".gitignore"
+documentation:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "**/*.md"
+          - "Makefile"
+          - "**/*.md"
+          - "mkdocs.yml"
+github-actions:
+  - changed-files:
+      - any-glob-to-any-file:
+          - ".github/workflows/**/*"
+needs-review:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "**"

.github/workflows/docs.yml

@@ -12,7 +12,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Setup Python
-        uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
         with:
           python-version: 3.x
       - name: Install Dependencies

.github/workflows/pull-requests.yml

@@ -0,0 +1,27 @@
+---
+name: Pull Request Labels
+
+on:
+  pull_request_target:
+    branches:
+      - develop
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - edited
+      - ready_for_review
+
+jobs:
+  labeler:
+    name: Labeler
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Apply Labels
+        uses: actions/labeler@8558fd74291d67161a8a78ce36a881fa63b766a9 # v5.0.0
+        with:
+          configuration-path: .github/labeler-pull-requests.yml
+          repo-token: '${{ secrets.GITHUB_TOKEN }}'

.github/workflows/release.yml

@@ -136,7 +136,7 @@ jobs:
           ref: ${{ github.event.release.tag_name }}
           fetch-depth: 0
       - name: Setup Python
-        uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
+        uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
         with:
           python-version: 3.x
       - name: Install Dependencies

.github/workflows/stale.yml

@@ -10,7 +10,7 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: actions/stale@28ca1036281a5e5922ead5184a1bbf96e5fc984e # v9.0.0
+      - uses: actions/stale@5bef64f19d7facfb25b37b414482c7164d639639 # v9.1.0
         with:
           repo-token: '${{ secrets.GITHUB_TOKEN }}'
           days-before-stale: 60

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Release History
 
+## v2.5.0
+
+> Released: Unreleased
+
+- Added cmdlets for auditing PCI Compliance in VMware Cloud Foundation 5.2 and later.
+  - Added `Get-VCFCompliance` to retrieve a specific compliance audit result.
+  - Added `Get-VCFComplianceConfiguration` to retrieve a list of all compliance configurations along with their applicable resource types and versions.
+  - Added `Get-VCFComplianceHistory` to retrieve the history for all compliance audits that have been performed.
+  - Added `Get-VCFComplianceStandard` to retrieve a list of all compliance audit standards and versions that are supported.
+  - Added `Get-VCFCompliance` to retrieve a specific compliance audit result.
+  - Added `New-VCFCompliance` to run a new compliance audit.
+- Added `Export-VCFManagementDomainJsonSpec` to export the JSON specification required for bring-up from the Planning and Preparation workbook.
+- Enhanced the request headers to include `Content-Type` to ensure REST API calls do not error out.
+- Enhanced `ResponseException` function to accept optional `-Body` parameter to include the JSON payload for ease of debugging.
+- Enhanced `New-VCFWorkloadDomain` cmdlet to improve error handling.
+- Enhanced `New-VCFCommissionedHost` cmdlet to improve error handling.
+- Enhanced `New-VCFCommissionedHost` cmdlet with ability to use the host commission JSON specification provided by the SDDC Manager UI.
+- Updated `Get-VCFTask` cmdlet with additional exception message to catch.
+- Updated `Get-VCFSystemPrecheckTask` cmdlet with optional parameter `failureOnly`.
+- Updated `Get-VCFPersonality` cmdlet with optional parameter `name`.
+- Updated `New-VCFWorkloadDomain` cmdlet with optional parameter `validate` to validate the JSON specification.
+- Refactored `Invoke-VCFCommand` to run commands on SDDC Manager without the need for SSH across PowerShell editions and operating systems.
+- Removed deprecated `Commission-VCFHost` alias from `New-VCFCommissionedHost`.
+- Removed deprecated `Decommission-VCFHost` alias from `Remove-VCFCommissionedHost`.
+- Removed deprecated `Get-VCFNsxManagerCluster` alias from `Get-VCFNsxtCluster`.
+- Removed deprecated `Get-VCFNsxEdgeCluster` alias from `Get-VCFEdgeCluster`.
+- Removed deprecated `New-VCFNsxEdgeCluster` alias from `New-VCFEdgeCluster`.
+
 ## v2.4.1
 
 > Released: 2023-12-15

LICENSE

@@ -1,6 +1,6 @@
 BSD 2-Clause License
 
-Copyright 2023 Broadcom. All Rights Reserved.
+Copyright 2023-2024 Broadcom. All Rights Reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
 following conditions are met:

Makefile

@@ -1,4 +1,4 @@
-# Copyright 2023 Broadcom. All Rights Reserved.
+# Copyright 2023-2024 Broadcom. All Rights Reserved.
 # SPDX-License-Identifier: BSD-2
 
 docs-install:

NOTICE

@@ -1,5 +1,5 @@
 PowerShell Module for VMware Cloud Foundation
-Copyright 2023 Broadcom. All Rights Reserved.
+Copyright 2023-2024 Broadcom. All Rights Reserved.
 
 This product is licensed to you under the BSD-2 license (the "License").  You may not use this product except in
 compliance with the BSD-2 License.

PowerVCF.psd1

@@ -1,100 +1,100 @@
-# Copyright 2023 Broadcom. All Rights Reserved.
+# Copyright 2023-2024 Broadcom. All Rights Reserved.
 # SPDX-License-Identifier: BSD-2
 
 # Module manifest for module 'PowerVCF'
 # Generated by: Broadcom
-# Generated on: 2023-12-15
+# Generated on: 2024-07-02
 
 @{
 
-# Script module or binary module file associated with this manifest.
-RootModule = 'PowerVCF.psm1'
+    # Script module or binary module file associated with this manifest.
+    RootModule        = 'PowerVCF.psm1'
 
-# Version number of this module.
-ModuleVersion = '2.4.1.1000'
+    # Version number of this module.
+    ModuleVersion     = '2.5.0.1016'
 
-# Supported PSEditions
-# CompatiblePSEditions = @()
+    # Supported PSEditions
+    # CompatiblePSEditions = @()
 
-# ID used to uniquely identify this module
-GUID = '0558cc7e-71a6-4b08-b9be-341d22653128'
+    # ID used to uniquely identify this module
+    GUID              = '0558cc7e-71a6-4b08-b9be-341d22653128'
 
-# Author of this module
-Author = 'Broadcom'
+    # Author of this module
+    Author            = 'Broadcom'
 
-# Company or vendor of this module
-CompanyName = 'Broadcom'
+    # Company or vendor of this module
+    CompanyName       = 'Broadcom'
 
-# Copyright statement for this module
-Copyright = 'Copyright 2023 Broadcom. All Rights Reserved.'
+    # Copyright statement for this module
+    Copyright         = 'Copyright 2023-2024 Broadcom. All Rights Reserved.'
 
-# Description of the functionality provided by this module
-Description = 'PowerShell Module for VMware Cloud Foundation'
+    # Description of the functionality provided by this module
+    Description       = 'PowerShell Module for VMware Cloud Foundation'
 
-# Minimum version of the Windows PowerShell engine required by this module
-# PowerShellVersion = '5.0'
+    # Minimum version of the Windows PowerShell engine required by this module
+    # PowerShellVersion = '5.0'
 
-# Name of the Windows PowerShell host required by this module
-# PowerShellHostName = ''
+    # 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 the Windows PowerShell host required by this module
+    # PowerShellHostVersion = ''
 
-# Modules that must be imported into the global environment prior to importing this module
-# RequiredModules = @('')
+    # Modules that must be imported into the global environment prior to importing this module
+    # RequiredModules = @('')
 
-# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
-# NestedModules = @()
+    # 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 = '*'
+    # 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 = '*'
 
-# 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 = '*'
+    # 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 = '*'
+    # 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 = @()
+    # 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 = @()
+    # DSC resources to export from this module
+    # DscResourcesToExport = @()
 
-# List of all modules packaged with this module
-# ModuleList = @()
+    # List of all modules packaged with this module
+    # ModuleList = @()
 
-# List of all files packaged with this module
-# FileList = @()
+    # 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 = @{
+    # 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 = @{
+        PSData = @{
 
-        # Tags applied to this module. These help with module discovery in online galleries.
-        Tags = @('VMware', 'CloudFoundation', 'VMwareCloudFoundation')
+            # Tags applied to this module. These help with module discovery in online galleries.
+            Tags         = @('VMware', 'CloudFoundation', 'VMwareCloudFoundation')
 
-        # A URL to the license for this module.
-        LicenseUri = 'https://github.com/vmware/powershell-module-for-vmware-cloud-foundation/blob/main/LICENSE'
+            # A URL to the license for this module.
+            LicenseUri   = 'https://github.com/vmware/powershell-module-for-vmware-cloud-foundation/blob/main/LICENSE'
 
-        # A URL to the main website for this project.
-        ProjectUri = 'https://vmware.github.io/powershell-module-for-vmware-cloud-foundation'
+            # A URL to the main website for this project.
+            ProjectUri   = 'https://vmware.github.io/powershell-module-for-vmware-cloud-foundation'
 
-        # A URL to an icon representing this module.
-        IconUri = 'https://raw.githubusercontent.com/vmware/powershell-module-for-vmware-cloud-foundation/main/.github/icon-85px.svg'
+            # A URL to an icon representing this module.
+            IconUri      = 'https://raw.githubusercontent.com/vmware/powershell-module-for-vmware-cloud-foundation/main/.github/icon-85px.svg'
 
-        # ReleaseNotes of this module
-        ReleaseNotes = 'https://vmware.github.io/powershell-module-for-vmware-cloud-foundation/release-notes/'
+            # ReleaseNotes of this module
+            ReleaseNotes = 'https://vmware.github.io/powershell-module-for-vmware-cloud-foundation/release-notes/'
 
-    } # End of PSData hashtable
+        } # End of PSData hashtable
 
-} # End of PrivateData hashtable
+    } # End of PrivateData hashtable
 
-# HelpInfo URI of this module
-# HelpInfoURI = ''
+    # HelpInfo URI of this module
+    # HelpInfoURI = ''
 
-# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
-# DefaultCommandPrefix = ''
+    # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+    # DefaultCommandPrefix = ''
 
 }