HPE Compute Ops Management PowerShell Library

The HPE Compute Ops Management PowerShell library (HPECOMCmdlets) offers a comprehensive suite of cmdlets designed to manage and automate your HPE GreenLake environment. By leveraging this library, users can seamlessly interact with HPE GreenLake and Compute Ops Management services directly from the PowerShell command line, enabling efficient integration into existing automation workflows and enhancing operational efficiency.

Development is ongoing, and the library will be continuously updated to support new features as they are released by HPE.

Latest release

1.0.15

📘 For detailed insights, tutorials, and updates, visit my blog: PowerShell Library for HPE Compute Ops Management.

Requirements

• Supported PowerShell Version: 7 or higher.

  Note: PowerShell version 5 is no longer supported.

• Supported PowerShell Editions: PowerShell Core version 7 or higher.

• HPE Account: An HPE Account is necessary to connect to the HPE GreenLake platform and any Compute Ops Management services.

  Note: If you do not have an HPE Account, you can create one here. To learn how to create an HPE account, see Getting started with HPE GreenLake

  Note: To interact with an HPE GreenLake workspace and a Compute Ops Management instance using this library, you must have at least the Observer role for both HPE GreenLake Platform and Compute Ops Management service managers. This role grants view-only privileges. For modification capabilities, you need either the Operator (view and edit privileges) or the Administrator (view, edit, and delete privileges) role. Alternatively, you can create a custom role that meets your specific access requirements.

• Supported authentication methodes:

  • Single-factor authentication (username and password).

  • Multi-factor authentication (MFA) using Google Authenticator or Okta Verify.

    • To use MFA, ensure that the Okta Verify or Google Authenticator app is installed on your mobile device and properly linked to your account before initiating the connection process.
    • MFA with security keys or biometric authenticators is not supported.
    • If your HPE GreenLake account is configured to use only security keys or biometric authenticators for MFA, you must enable either Google Authenticator or Okta Verify in your account settings to use this library.
    • For accounts with Google Authenticator enabled, you will be prompted to enter the verification code.
    • For accounts with Okta Verify enabled, you will need to approve the push notification on your phone.
    • If both Google Authenticator and Okta Verify are enabled, the library defaults to using Okta Verify push notifications.

  • SAML Single Sign-On (SSO) is available for users with an hpe.com email address only.

    • This library supports SAML Single Sign-On (SSO) but exclusively for hpe.com email addresses. Other domains or identity providers are not supported for direct SSO authentication.
    • To use SSO, ensure that the Okta Verify app is installed on your mobile device and properly linked to your account before initiating the connection process.
    • Users leveraging SAML SSO through other identity providers cannot authenticate directly using their corporate credentials with the Connect-HPEGL cmdlet.
      • As a workaround, invite a user with an email address that is not associated with any SAML SSO domains configured in the workspace. This can be done via the HPE GreenLake GUI under User Management by selecting Invite Users Assign the HPE GreenLake Account Administrator role to the invited user. Once the invitation is accepted, the user can set a password and use these credentials to log in with Connect-HPEGL.

  Note: You do not need an existing HPE GreenLake workspace to connect. You can create a new workspace after your first connection using the New-HPEGLWorkspace cmdlet.

How to Install the Module

To install the library, use the following command to download and install the module from the official PowerShell Gallery:

Install-Module HPECOMCmdlets

How to Upgrade the Module

If you have already installed the module and need to update it to the latest version, run the following commands:

# Get the currently installed version
$latestVersion = (Get-InstalledModule HPECOMCmdlets | Sort-Object Version -Descending | Select-Object -First 1).Version
# Install latest version of the HPECOMCmdlets module
Install-Module -Name HPECOMCmdlets -Force -AllowClobber
# Uninstall the old version of the module
Uninstall-Module -Name "HPECOMCmdlets" -RequiredVersion $latestVersion

Support

If you encounter any issues or unexpected behavior, please open a new issue on my GitHub issue tracker for assistance.

For general questions or discussions that don't require tracking, join our GitHub Discussions.

Disclaimer

Please note that the HPE GreenLake APIs are subject to change. Such changes can impact the functionality of this library. We recommend keeping the library updated to the latest version to ensure compatibility with the latest API changes.

Want more?

🔗 PowerShell Gallery

• HPE GreenLake Edge-to-Cloud Platform User Guide
• HPE Compute Ops Management User Guide
• HPE GreenLake Developer Portal

License

This library is provided under the MIT License. See the full license text in the module manifest for more details.

Author

Lionel Jullien, Hewlett Packard Enterprise