Skip to content

Release v1.0.20

Choose a tag to compare

View all tags
@jullienl jullienl released this 30 Jan 11:04
· 23 commits to main since this release
v1.0.20
2d37d9c

🎯 What's New in v1.0.20

New Features

Approval Policy Management

Complete approval policy lifecycle management cmdlets for HPE Compute Ops Management:

  • Get-HPECOMApprovalPolicy: Retrieve approval policies with support for:

    • List all policies or filter by name
    • -ShowPolicyDetails for full configuration including approvables and resources
    • Pipeline output with resourceUri for seamless integration with Set/Remove cmdlets
    • WhatIf support for API preview

  • New-HPECOMApprovalPolicy: Create approval policies with advanced validation:

    • 12 individual action parameters matching UI design: EnableAllApprovers, UpdateFirmwareApprovers, ApplyInternalStorageConfigurationApprovers, InstallOperatingSystemImageApprovers, ApplyExternalStorageConfigurationApprovers, PowerOnApprovers, PowerOffApprovers, ResetApprovers, ColdBootApprovers, UpdateiLOFirmwareApprovers, ApplyServerSettingsApprovers, DownloadFirmwareApprovers
    • Each action has separate Approvers (email list) and Required (1-4) parameters
    • EnableAllApprovers: Special parameter that expands to all 11 individual actions automatically

  • Set-HPECOMApprovalPolicy: Update existing policies with same validation as New:

    • Accepts policy by Name or ResourceUri (pipeline compatible)
    • CRITICAL BEHAVIOR: If ANY action parameter specified, ALL existing actions REPLACED with new configuration
    • To preserve existing actions while modifying: Must specify all actions you want in the policy
    • If NO action parameters specified: Existing actions preserved unchanged
    • Can update Name (-NewName), Description, and GroupNames independently without affecting actions
    • Same validation as New: user existence, group existence, collects all errors
    • Pipeline support from Get-HPECOMApprovalPolicy

  • Remove-HPECOMApprovalPolicy: Delete policies with validation:

    • Accepts policy by Name or ResourceUri (pipeline compatible)
    • Pre-validation: Verifies policy exists before attempting deletion
    • Pipeline support from Get-HPECOMApprovalPolicy

Enhanced Functionality

Server Management Enhancements

Get-HPECOMAlert - New Function for Retrieving Server Alerts

  • New standalone function to retrieve server security alerts and issues
  • Supports retrieving alerts for all servers in a region or for a specific server by name/serial number
  • Consistent pattern with Get-HPECOMActivity and Get-HPECOMJob (uses -SourceName parameter)
  • Supports pipeline input from Get-HPECOMServer
  • Default behavior: Shows all alerts regardless of age (alerts persist until cleared, unlike temporal activities)
  • Time filtering options: -ShowLastWeek (7 days), -ShowLastMonth, -ShowLastThreeMonths
  • Returns alert objects sorted by creation date (most recent first) with properties: serverName, serialNumber, serverId, createdAt (DateTime), description, severity, category, region
  • Get-HPECOMServer -ShowAlerts now uses Get-HPECOMAlert internally for consistent behavior

Get-HPECOMServerLogs - New Function for Collecting and Downloading Server Logs

  • Collects server logs (AHS) asynchronously with download URL retrieval via /download-logs endpoint
  • Optional -Path for automatic download with timestamped filename,
  • -UploadToHPESupport for HPE support case analysis
  • Supports pipeline input for batch operations
  • Graceful timeout handling: Returns job URI with detailed instructions when timeout is reached

Get-HPECOMServer - New Parameters

  • Added -ShowActivities switch parameter to retrieve activities for specific server(s) or all servers in the region
  • Added -ShowAlerts switch parameter to retrieve alerts for specific server(s) or all servers in the region
  • Added -ShowJobs switch parameter to retrieve jobs for specific server(s) or all servers in the region

Get-HPECOMGroup - New Parameters

  • Added -ShowActivities switch parameter to retrieve activities for specific group(s) or all groups in the region
  • Added -ShowJobs switch parameter to retrieve jobs for specific group(s) or all groups in the region

Get-HPECOMAppliance - New Parameterrs

  • Added -ShowActivities switch parameter to retrieve activities for specific appliance(s) or all appliances
  • Added -ShowJobs switch parameter to retrieve jobs for specific appliance(s) or all appliances

Get-HPECOMJob - New SourceName Parameter for Resource-Based Job Filtering

  • Added -SourceName parameter to filter jobs by resource name (server, group, or appliance)
  • Clarified -Name parameter is exclusively for job names (e.g., 'IloOnlyFirmwareUpdate')
  • Follows the same pattern as Get-HPECOMActivity for consistent resource filtering
  • Automatically detects resource type and applies appropriate filter (associatedResourceId for servers, resource/id for groups/appliances)

Session Management Enhancements

Connect-HPEGL - New Session Methods and Properties

  • Clone() Method: Creates deep copy of session object for instant restoration without API calls, ideal for switching between workspaces
  • IsValid Property: Dynamically checks if session is valid by verifying both OAuth2 and GLP API token expiration

Bug Fixes

Enhanced Error Handling Across All Cmdlets

  • Improved catch block error handling to prioritize enhanced error messages from API wrappers
  • Detailed 403 Forbidden errors now show cause, required actions, and technical details for troubleshooting

Connect-HPEGLDeviceComputeiLOtoCOM - Enhanced Error Detection and Reporting

  • Fixed duplicate object output on timeout and added real-time FailReason detection (checks every 4 seconds)
  • Reports specific errors within 4-8 seconds instead of waiting for full timeout

Connect-HPEGLDeviceComputeiLOtoCOM - New Proxy Management Parameters

  • -RemoveExistingiLOProxySettings: Removes existing iLO proxy configuration before connecting to COM
  • -ResetiLOIfProxyErrorPersists: Automated iLO reset when proxy errors persist after removal (addresses iLO firmware limitation)
  • Enhanced proxy removal workflow with verification and automatic CloudConnect disable

New-HPEGLScopeGroup - Fixed API Payload Issue

  • Removed unsupported resourceProviderName field from API request payload that was causing rejection errors

New-HPEGLService - Fixed Parameter Name Error

  • Fixed internal code using outdated -ComputeOpsManagementRole parameter, updated to correct -RoleName parameter
  • Also updated documentation and example scripts

Get-HPECOMActivity - Fixed -SourceName Parameter

  • Fixed internal call error, URL encoding, and improved error handling
  • Now correctly retrieves activities by source name for servers, groups, appliances, and external services
  • Fixed appliance activity filtering by adding proper type prefix mapping (gateway+, oneview+)

Get-HPECOMServerUtilizationInsights - Enhanced Error Messages and Warnings

  • Fixed URL encoding to use uppercase hex (%2F, %2B) as required by API
  • Enhanced warnings for excluded servers with detailed causes and resolution steps
  • Suppressed redundant warnings and added verbose debugging output

Get-HPECOMSustainabilityInsights - Enhanced Filtering and Error Messages

  • Renamed parameter from -SerialNumber to -Name accepting both hostnames and serial numbers (aliases added for backward compatibility)
  • Fixed filtering to check both serialNumber and name fields
  • Added detailed warning when servers have no sustainability data with resolution steps

Invoke-HPECOMWebRequest and Invoke-HPEGLWebRequest - Fixed -ReturnFullObject Behavior

  • Now correctly returns full response object when -ReturnFullObject is used, even when total=0
  • Ensures access to important response properties like excluded, count, and metadata

Get-HPECOMServerInventory - Fixed -ShowSoftware and -ShowSmartUpdateTool Error Handling

  • Enhanced warning message for -ShowSoftware when data is unavailable to specifically mention HPE Agentless Management Service (AMS) requirement
  • Enhanced warning message for -ShowSmartUpdateTool when data is unavailable to specifically mention Smart Update Tool (SUT) installation requirement
  • Warning now displays even when full inventory collection has been previously run, as software and SUT inventory require respective services to be running on the server OS
  • Fixed null reference error when attempting to add serverName property to null data
  • Added null check before adding member properties to prevent failures when inventory data is unavailable

📦 Installation & Upgrade

🚀 See How to Upgrade the Module

📖 Documentation & Resources

🙏 Feedback & Contributions

We'd love to hear your feedback! If you encounter any issues or have suggestions for improvements, please open an issue or start a discussion on GitHub.

Full Changelog: v1.0.19...v1.0.20

Assets 2
Loading