vmware/power-validated-solutions-for-cloud-foundation

PowerShell Module for VMware Validated Solutions

PowerShell Module for VMware Validated Solutions

  

  

Overview

PowerValidatedSolutions is a PowerShell module that has been written to support the automation of many procedures associated with the implementation of the VMware Validated Solutions for VMware Cloud Foundation.

The module helps reduce human error, delivers consistency and robustness, and accelerates the time-to-deploy these solutions. The module's cmdlets reduce complexity by automating the deployment and configuration steps using the product APIs or command-line tools.

This infrastructure-as-code model enables you to use the module to accelerate the deployment and management of the VMware Validate Solutions or use it in your own end-to-end automation.

Documentation

Please refer to the documentation for more information on how to use this module.

Contributing

The project team welcomes contributions from the community. Before you start working with PowerValidatedSolutions, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch.

For more detailed information, refer to the contribution guidelines to get started.

Support

While this module is not supported by VMware Support Services, it is supported by the project maintainers and its community of users.

Use the GitHub issues to report bugs or suggest features and enhancements. Issues are monitored by the maintainers and are prioritized based on criticality and community reactions.

Before filing an issue, please search the issues and use the reactions feature to add votes to matching issues. Please include as much information as you can. Details like these are incredibly useful in helping the us evaluate and prioritize any changes:

• A reproducible test case or series of steps.
• Any modifications you've made relevant to the bug.
• Anything unusual about your environment or deployment.

You can also start a discussion on the GitHub discussions area to ask questions or share ideas.

License

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:

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.

power-validated-solutions-for-cloud-foundation's Issues

Add additional metadata to PowerShell Gallery listing

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

List the following alongside the module in the PowerShell Gallery:

• License: GitHub link to the license.
• Release Notes: Ghthub link to Change Log)
• Icon: Link to a transparent .png image for the project.
• Project: GitHub link to the project.

Use Case(s)

Enhance metadata provided to a user when visiting the PowerShell Gallery.

Potential Configuration

Example additions to the PowerValidatedSolutions.psd1 file:

# 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 = @('VMware', 'Validated Solutions', 'Cloud Foundation')

        # A URL to the license for this module.
        LicenseUri = 'https://github.com/vmware-samples/power-validated-solutions-for-cloud-foundation/blob/main/LICENSE'

        # A URL to the main website for this project.
        ProjectUri = 'https://github.com/vmware-samples/power-validated-solutions-for-cloud-foundation/'

        # A URL to an icon representing this module.
        IconUri = 'https://github.com/vmware-samples/power-validated-solutions-for-cloud-foundation/blob/main/icon.png'

        # ReleaseNotes of this module
        ReleaseNotes = 'https://github.com/vmware-samples/power-validated-solutions-for-cloud-foundation/blob/main/CHANGELOG.md'

    } # End of PSData hashtable

} # End of PrivateData hashtable

References

No response

Update DRI SampleScripts to Support VCF 4.5 PnP Workbook

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Updated DRI SampleScripts to Support VCF 4.5 PnP Workbook

Use Case(s)

• Support VCF 4.5 Planning and Prep Workbook

Potential Configuration

n/a

References

No response

Add support for vRealize Automation Cloud proxies with global regions

Description

vRealize Automation Cloud is available in multiple global regions. For organizations located outside of the United States, you must prefix the URL with the country abbreviation for your API endpoint as shown in the following examples.

Use Case(s)

This enhancement will ensure that users outside of the United States can use the capabilities of the cmdlets.

Potential Configuration

Should we consider adding a validate set with a -geo and then amend the prefix to the base URI.

• United States: https://api.mgmt.cloud.vmware.com/.
• United Kingdom: https://uk.api.mgmt.cloud.vmware.com/
• Japan: https://jp.api.mgmt.cloud.vmware.com/
• Singapore: https://sg.api.mgmt.cloud.vmware.com/
• Germany: https://de.api.mgmt.cloud.vmware.com/
• Australia: https://au.api.mgmt.cloud.vmware.com/
• Canada: https://ca.api.mgmt.cloud.vmware.com/
• Brazil: https://br.api.mgmt.cloud.vmware.com/

Updates to:

• Get-CloudProxy
• Get-CloudProxyOtk

Possible use of a shared function.

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Add support for the addition of the vSphere Replication adapter Instances to vRealize Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the addition of the vSphere Replication adapter Instances to vRealize Operations.

Similar to the existing functions for Add-vROPSAdapterPing, Add-vROPSAdapterSddcHealth, and Add-vROPSAdapterNsxt.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance:

• Add vSphere Replication Adapter Instances to vRealize Operations Manager

Add support to configure replication, protection, and recovery plans

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the configuration of replication, protection group, and recovery plan for:

• Aria Suite Lifecycle
• Aria Operations (cluster)
• Aria Automation (cluster)
• Workspace ONE Access (cluster)

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Replication, Create a Protection Group and a Recovery Plan for vRealize Automation

[BUG] Adding Tags/Catergories to vCenter Server Fails due to multiple objects

Description

When you add the tags/categories to vCenter Server, two objects are created which causes the function to fail. This is because by default no -Server value is passed and they are created on all vCenter Servers that are part of the Single-Sign On domain.

Expected Behavior

Single object created

Add support for adding the management domain vCenter Server in an additional VMware Cloud Foundation Instance to vRealize Suite Lifecycle Manager

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the adding the management domain vCenter Server in an additional VMware Cloud Foundation Instance to vRealize Suite Lifecycle Manager.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Add the Management Domain vCenter Server in the Additional VMware Cloud Foundation Instance to vRealize Suite Lifecycle Manager

Add support to verify the integration of vRealize Operations Manager with vRealize Log Insight

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to verify the integration of vRealize Operations Manager with vRealize Log Insight.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Verify the Integration of vRealize Operations Manager with vRealize Log Insight

Update IAM SampleScripts to Support VCF 4.5 PnP Workbook

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

The SampleScripts for IAM require an update to support the VCF 4.5 Planning and Prep Workbook

Use Case(s)

• Support VCF 4.5

Potential Configuration

n/a

References

No response

Functions `checkVCFToken` and `Get-JWTDetail` are exported but not used in the module

Code of Conduct

• I have read and agree to the Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

VMware Cloud Foundation

4.4.1

Module Version

1.7.0

PowerShell Version

Windows PowerShell 5.1

PowerCLI Version

12.7.0

PowerVCF Version

2.2.0

Guest Operating System

Windows Server 2022

Environment Details

No additional information.

Description

The following functions are included in the module and exported; however, these are not used in the module.

These are however included in the PowerVCF module where they are not exported and are used extensively.

• checkVCFToken
• Get-JWTDetail

Error or Debug Output

See attached screenshot.

Expected Behavior

The cmdlets should not be repeated or conflict.

Actual Behavior

See attached screenshot.

Steps to Reproduce

If you first install PowerValidatedSolutions and then try to install PowerVCF it will return an error.

Log Fragments and Files

No response

Screenshots

References

No response

Add support to verify the log forwarding status of vRealize Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the verification of the log forwarding status of vRealize Operations.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Verify the Log Forwarding Status of vRealize Operations Manager

Test-vROPsAdapterStatusByType - Message Output is Confusing for a Customer

Description

When you execute the Test-vROPsAdapterStatusByType cmdlet to obtain the status of the Adapter from vROPS if its anything other than GREEN a Write-Error is currently used to display the output to the customer.

Whilst anything that is not GREEN is not a good sign it would be better to output using a Write-Output so the message is displayed cleanly, using the current approach makes it look like the cmdlet failed which in fact it did not.

Expected Behavior

Output Message would be better using Write-Output which would display just this:

Adapter Name : sfo-wsa01.sfo.rainpole.io, Health Status: RED, check the log status

Actual Behavior

Test-vROPSAdapterStatus : Adapter Name : vRSLCM_VCF_Workspace ONE Access Adapter - xint-wsa01.rainpole.io, Health Status: RED, check the log status
At C:\Program Files\WindowsPowerShell\Modules\PowerValidatedSolutions\1.8.0.1001\PowerValidatedSolutions.psm1:12923 char:41

• ... Test-vROPSAdapterStatus -resourceId $_.id

•                             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  

  • CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
  • FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,Test-vROPsAdapterStatus

Test-vROPSAdapterStatus : Adapter Name : sfo-wsa01.sfo.rainpole.io, Health Status: RED, check the log status
At C:\Program Files\WindowsPowerShell\Modules\PowerValidatedSolutions\1.8.0.1001\PowerValidatedSolutions.psm1:12923 char:41

• ... Test-vROPSAdapterStatus -resourceId $_.id

•                             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  

  • CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
  • FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,Test-vROPsAdapterStatus

Add support to configure service account permissions in vSphere for Integration with vRealize Suite Lifecycle Manager.

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to configure service account permissions in vSphere for Integration with vRealize Suite Lifecycle Manager.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Service Account Permissions in vSphere for Integration with vRealize Suite Lifecycle Manager

[FEATURE] Add Support for Adding an Identity Source to Clustered WSA Using Add-WorkspaceOneDirectory

Description

Add support within the Add-WorkspaceOneDirectory to support adding an Identity Source for both Standalone and Clustered instances of Workspace ONE Access.

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Add support for creating notifications in vRealize Operations Manager using a JSON payload

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the creation of notifications in vRealize Operations using a JSON payload (rather than CSV.)

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Create Notifications in vRealize Operations Manager for VMware Cloud Foundation Issues

Add support for installing the vRealize Orchestrator content pack for vRealize Log Insight (online-mode)

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the installing the vRealize Orchestrator content pack for vRealize Log Insight from the GitHub repository.

Use Case(s)

Also, this could be use for other content packs as/if needed by the user.

Potential Configuration

To be determined during implementation.

References

Guidance: Install the vRealize Orchestrator Content Pack for vRealize Log Insight

Add support to customize the recovery plans for Aria Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable customization of the recovery plans for:

• Aria Operations (Analytics Cluster)

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Customize the Recovery Plan for vRealize Operations Manager

Add support to replace the SSL certificate on Aria Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the replace the SSL certificate on Aria Operations.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Replace the SSL Certificate on vRealize Operations Manager

Add support for deploying vRealize Operations remote collector nodes

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the deployment of vRealize Operations Manager remote collector nodes in an additional VMware Cloud Foundation instance using vRealize Suite Lifecycle Manager.

Note

Cloud Proxies is out of scope.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Deploy vRealize Operations Manager Remote Collector Nodes in an Additional VMware Cloud Foundation Instance by Using vRealize Suite Lifecycle Manager

Add support to customize the recovery plans

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable customization of the recovery plans for:

• Aria Suite Lifecycle
• Aria Operations
• Aria Automation
• Workspace ONE Access (cluster)

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Customize the Recovery Plan for vRealize Suite Lifecycle Manager and the Clustered Workspace ONE Access

Add support to online update content packs in vRealize Log Insight

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the online update of content packs in vRealize Log Insight.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Example Guidance: Upgrade the Content Packs on vRealize Log Insight

Add support to create notifications in vRealize Operations Manager for Site Protection and Disaster Recovery

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop / enhance PowerShell cmdlet(s) and CSV/JSO to enable the create notifications in vRealize Operations Manager for Site Protection and Disaster Recovery

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance:

• Create Notifications in vRealize Operations Manager for Site Protection and Disaster Recovery Issues
• #53

Add support to configure the ESXi password expiration policy

Description

Add the ability to configure the ESXi Password Expiration Policy

Use Case(s)

I'm a SRE (Site Resiliency Engineer) and need to be able to adjust the password expiration policy on multiple ESXi within my VMware Cloud Foundation instance based on a vSphere cluster.

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

`Get-NsxtEdgeNode` cmdlet example uses incorrect value

Code of Conduct

• I have read and agree to the Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

VMware Cloud Foundation

4.4.1

Module Version

1.7.0

PowerShell Version

Windows Powershell 5.1

PowerCLI Version

12.6.0.19610541

PowerVCF Version

2.2.0

Guest Operating System

Windows Server 2019

Environment Details

No response

Description

get-help Get-NsxtEdgeNode -example is showing wrong values for transport ID

------------------
NAME
    Get-NsxtEdgeNode

SYNOPSIS
    Get details for NSX Edge.


    -------------------------- EXAMPLE 1 --------------------------

    PS C:\>Get-NsxtEdgeNode -transportNodeId sfo-w01-nsx01.sfo.rainpole.io

    This example returns the details of an NSX Edge node
----------------

When run it returns the error as seen in the screenshot.

Error or Debug Output

See screenshots.

Expected Behavior

See screenshots.

Actual Behavior

See screenshots.

Steps to Reproduce

Get-NsxtEdgeNode -transportNodeId sfo-w01-nsx01.sfo.rainpole.io

Log Fragments and Files

No response

Screenshots

References

No response

Add support to configure replication, protection, and recovery plan for Aria Lifecycle and Workspace ONE Access

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the configuration of replication, protection group, and recovery plan for:

• Aria Lifecycle
• Workspace ONE Access cluster

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Replication, Create a Protection Group and a Recovery Plan for vRealize Suite Lifecycle Manager and Clustered Workspace ONE Access

Add support to verify the Integration status of the vRealize Automation adapter in vRealize Operations

Description

Add a new function to verify the integration status between vRealize Operations Manager and configured adapter

Use Case(s)

Validate the integration status between vRealize Operations Manager and configured adapter to ensure that the adapter is configured correctly, the provided service account has correct privileges.

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

`Set-NsxtComputeManager` removes the value from `dispay_name` property of the compute manager object

Code of Conduct

• I have read and agree to the Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

VMware Cloud Foundation

4.4.1

Module Version

1.7.0

PowerShell Version

5.1.19041.1682

PowerCLI Version

12.5.0.19195797

PowerVCF Version

2.2.0

Guest Operating System

Windows 10 pro

Environment Details

VCF 4.4.1.1 with Management domain only in test environment

Description

Set-NsxtComputeManager -EnableTrust:$false
Removes the value from display_name property if previously set display_name property is mandatory in UI.

Error or Debug Output

PS > Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local

server                   : vcenter-1.vrack.vsphere.local
origin_type              : vCenter
credential               : @{thumbprint=<redacted>; credential_type=UsernamePasswordLoginCredential}        
origin_properties        : {@{key=fullName; value=VMware vCenter Server 7.0.3 build-20395099}, @{key=localeVersion; value=INTL}, @{key=version; value=7.0.3},
                           @{key=originComputeManagerDescription; value=}...}
create_service_account   : False
set_as_oidc_provider     : True
access_level_for_oidc    : FULL
reverse_proxy_https_port : 443
resource_type            : ComputeManager
id                       : 5ec568c4-3208-4943-9527-db9cc7bce7ff
display_name             : vcenter-1.vrack.vsphere.local
description              :
_create_time             : 1662969789009
_create_user             : system
_last_modified_time      : 1663764820110
_last_modified_user      : system
_revision                : 6

PS > Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local | Set-NsxtComputeManager -EnableTrust:$false

server                   : vcenter-1.vrack.vsphere.local
origin_type              : vCenter
credential               : @{thumbprint=<redacted>; credential_type=UsernamePasswordLoginCredential}        
origin_properties        : {@{key=fullName; value=VMware vCenter Server 7.0.3 build-20395099}, @{key=localeVersion; value=INTL}, @{key=version; value=7.0.3},
                           @{key=originComputeManagerDescription; value=}...}
create_service_account   : False
set_as_oidc_provider     : False
access_level_for_oidc    : FULL
reverse_proxy_https_port : 443
resource_type            : ComputeManager
id                       : 5ec568c4-3208-4943-9527-db9cc7bce7ff
display_name             :
description              :
_create_time             : 1662969789009
_create_user             : system
_last_modified_time      : 1663764867330
_last_modified_user      : system
_revision                : 7

PS > Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local

server                   : vcenter-1.vrack.vsphere.local
origin_type              : vCenter
credential               : @{thumbprint=<redacted>; credential_type=UsernamePasswordLoginCredential}        
origin_properties        : {@{key=fullName; value=VMware vCenter Server 7.0.3 build-20395099}, @{key=localeVersion; value=INTL}, @{key=version; value=7.0.3},
                           @{key=originComputeManagerDescription; value=}...}
create_service_account   : False
set_as_oidc_provider     : False
access_level_for_oidc    : FULL
reverse_proxy_https_port : 443
resource_type            : ComputeManager
id                       : 5ec568c4-3208-4943-9527-db9cc7bce7ff
display_name             :
description              :
_create_time             : 1662969789009
_create_user             : system
_last_modified_time      : 1663764867330
_last_modified_user      : system
_revision                : 7

Expected Behavior

Set-NsxtComputeManager -EnableTrust:$false should change only the trust flag

Actual Behavior

Set-NsxtComputeManager -EnableTrust:$false changes the trust flag and removed the value from display_name property.

Steps to Reproduce

1. Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local
2. Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local | Set-NsxtComputeManager -EnableTrust:$false
3. Get-NsxtComputeManager -vCenterServer vcenter-1.vrack.vsphere.local

Log Fragments and Files

No response

Screenshots

References

No response

Add support to configure event forwarding between vRealize Log Insight clusters

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to configure event forwarding between vRealize Log Insight clusters in VMware Cloud Foundation instances.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Event Forwarding Between VMware Cloud Foundation Instances

Add support to configure log forwarder filters in Aria Operations for Logs

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to configure event forwarding filters in vRealize Log Insight - prevents duplication of log data across vRealize Log Insight clusters.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Event Forwarding Filters to Prevent Duplicating Log Data in vRealize Log Insight

Add support for running the module on PowerShell 7

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Today, the module has been tested with Windows PowerShell 5.1.

This issue tracks investigation of support for PowerShell Core 7 (e.g., 7.2 LTS) on Windows.

Use Case(s)

Transition support PowerShell 7.

Potential Configuration

To be determined during investigation.

References

• PowerShell Support Lifecycle

Add support for downloading the Cloud Proxy and Cloud Extensibility Proxy from VMware Cloud

Description

Add a function that allows a customer to download the Cloud Proxy or Cloud Extensibility Proxy from the VMware Cloud.

Use Case(s)

• P0 - Ability to download to the desired path of the local system
• p0 - Ability to provide the download URL for scenarios where the OVA can be deployed directly from the download site
• P0 - Ability to download from either Production or Staging instances of VMware Cloud

Potential Configuration

Get-CloudProxy -environment production -type 'Cloud Proxy' -download -path <string>

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Add support to configure replication, protection, and recovery plan for Aria Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the configuration of replication, protection group, and recovery plan for:

• Aria Operations cluster

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Replication, Create a Protection Group and a Recovery Plan for vRealize Operations Manager Analytics Cluster

Add support for adding the vRealize Operations integration in vRealize Automation

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the addition of a vRealize Operations integration in vRealize Automation.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Integrate vRealize Automation with vRealize Operations Manager

Add support to update placement policy for cloud zones in vRealize Automation

Description

Add support within the Update-vRACloudZone and Update-vRACloudAccountZone function that allows a customer to update placement policy for cloud zones in vRealize Automation

Use Case(s)

Ability to change placement policy for cloud zones in vRealize Automation from DEFAULT to ADVACNED and vice versa after vRealize Operations Manager is integrated with vRealize Automation.

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Add automated acceptance tests using GitHub Actions

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Add automated acceptance tests using GitHub Actions.

For example:

• Linter (PowerShell, Markdown, JSON, YAML)
• Checkout and Import-Module on OS matrix
• Pester Tests
• Release

Use Case(s)

Ensure the health and release quality for the module

Potential Configuration

To be determined during implementation.

References

No response

Add documentation for the PowerShell module

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Today, the project’s documentation is contained within the module itself. While this has served its purpose, there’s an opportunity to transition the project to a more well-organized set of documentation for user consumption utilizing the following:

• GitHub Pages
• GitHub Actions
• MkDocs
• PlatyPS

Use Case(s)

Opportunity to provide a better documentation experience that covers the module basics.

The compartmentalization will also improve project exploration and maintenance.

Potential Configuration

To be determined during implementation.

References

• GitHub Pages Action

[BUG] Adding the SDDC Health Adapter is failing

Description

When executing the Add-vROPSAdapterSddcHealth to create the missing SDDC Health Monitoring Adapters it is failing with: ERROR Adding Adapter (SDDC Health Adapter Instance - sfo-vropsc01a) to vRealize Operations Manager (xint-vrops01.rainpole.io): POST_VALIDATION_FAILED

Expected Behavior

Adapter should be created without failing

Module Versions

To verify that the modules have loaded, run the following command in the PowerShell console:

v1.3.0

Add support to verify the integration of Aria Operations in Aria Automation

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the verification the integration of Aria Operations in Aria Automation.

This enhancement would be applicable to Step 2 (of 3):

• Verify the successful data collection for Aria Operations

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Verify the Integration of vRealize Automation with vRealize Operations Manager

Add support to obtain the One Time Key for Cloud Proxy or Cloud Extensibility Proxy

Description

Add the ability to obtain the One Time Key for Cloud Proxies:

• Cloud Proxy
• Cloud Extensibility Proxy

Use Case(s)

When deploying a Cloud Proxy or Cloud Extensibility Proxy for use with Cloud Assembly in VMware Cloud, a One Time Key (OTK) is required to establish secure communication with the VMware Cloud service.

Potential Configuration

Get-CloudProxyOtk -environment production -type 'Cloud Proxy'

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Add support to update the vRealize Automation Integration credential in vRealize Operations Manager

Description

Add a new function to update the vRealize Automation Integration credential in vRealize Operations Manager

Use Case(s)

Validate the following

• New vRA credential name does not already exist in vRealize Operations Manager
• Given credential is valid and update vRealize Automation adapter in vRealize Operations Manager
• Verify the vRealize Automation adapter status in vRealize Operations Manager after updating the credential

Potential Configuration

Community Note

Please vote on this issue by adding a 👍 reaction to the original issue to help the maintainers prioritize this request.

Please do not leave "+1" or "me too" comments. These generate noise for issue followers and do not help prioritize the request.

If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Enhance: Review Resolve-PSModule so its usable

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Resolve-PSModule currently exist within the PowerValidatedSolutions but it's not exported or usable for customers.

Make the required updates to expose and be of use at the command line.

Use Case(s)

• Check the status of supporting modules

Potential Configuration

n/a

References

No response

Address technical debt observed in the `PowerShell/PSScriptAnalyzer` linter

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Address technical debt observed in the PowerShell/PSScriptAnalyzer linter.

Once completed, this can be enabled as a GitHub Action to run Super-Linter on push and pull request for CI checks (along with a checkout and Import-Module on an OS matrix.)

Use Case(s)

Increase code quality and supportability of the PowerShell module.

Potential Configuration

To be determined during investigation - this issue may spawn related tracking issues.

References

• PowerShell/PSScriptAnalyzer

Add support for the addition of the Site Recovery Manager adapter Instances to vRealize Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable the addition of the Site Recovery Manager adapter Instances to vRealize Operations.

Similar to the existing functions for Add-vROPSAdapterPing, Add-vROPSAdapterSddcHealth, and Add-vROPSAdapterNsxt.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance:

• Add Site Recovery Manager Adapter Instances to vRealize Operations Manager

Add Support for Deploying a Single Node Workspace ONE Access Environment via vRSLCM

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Currently the New-WSADeployment cmdlet deploys only a Clustered Workspace ONE Access Environment via vRealize Suite Lifecycle Manager. With the pending change in the platform documentation where customers can choose between Standard (single node) or Clustered it would be good to support this option in code.

Use Case(s)

• Deploy Workspace ONE Access in Standard configuration via vRealize Suite Lifecycle Manager

Potential Configuration

Add as -standard parameter to the cmdlet to switch between modes

References

No response

Add support to configure privileges for the Aria Automation service account in Aria Operations

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

PowerShell function Import-vROPSUserGroup exists for adding user groups; however, a function for importing a user and associate to a particular adapter instance is also needed.

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Configure Privileges for the vRealize Automation Service Account in vRealize Operations Manager

Add support to enable vRealize Log Insight logging configuration for vRealize Automation

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to configure vRealize Automation to send logs to vRealize Log Insight over the ingestion API (SSL or Non-SSL) as a module add-on.

Use Case(s)

Provides an automation path for the procedure and future requirements.

Potential Configuration

To be determined during implementation.

References

No response

Add support to customize the recovery plans for Aria Automation

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Develop PowerShell cmdlet(s) to enable customization of the recovery plans for:

• Aria Automation cluster

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance: Customize the Recovery Plan for vRealize Automation

Improve code for `Add-ResourcePool` and `Undo-ResourcePool` cmdlets

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Add-ResourcePool and Undo-ResourcePool are not using the Test-Functions.

Use Case(s)

Additional code that can be reduced.

Potential Configuration

N/A

References

No response

Enhance the module to use status codes for API requests

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Enhance the module to use API status code, where applicable, for low-level API requests.

Use Case(s)

Enhanced error handling for API requests.

Potential Configuration

    $results = Invoke-Webrequest -uri https://api.rainpole.io/api/v1/hello -Method Get -headers $headers
    if($results.StatusCode -ne 200) {
        Write-Output "Whoopies!"
        break
    }

References

No response

Add support to `Enable-vROPSManagementPack` to support the management packs for site protection

Code of Conduct

• I have read and agree to the project's Code of Conduct.
• Vote on this issue by adding a 👍 reaction to the original issue initial description to help the maintainers prioritize.
• Do not leave "+1" or other comments that do not add relevant information or questions.
• If you are interested in working on this issue or have submitted a pull request, please leave a comment.

Description

Enhance the Enable-vROPSManagementPack to support the following management packs:

• Management Pack for vSphere Replication
• Management Pack for Site Recovery Manager

Use Case(s)

Provides an automation path for the procedure.

Potential Configuration

To be determined during implementation.

References

Guidance:

• Install the vRealize Operations Manager Management Packs for vSphere Replication and Site Recovery Manager