feat: add support for aria

Adds functions to retrieve password policies for each available VMware Aria product deployed in a VMware Cloud Foundation instance.

Thes functions are dependent on enhancements in `PowerValidatedSolutions` v2.9.0 (March 2024) milestone: `Get-vRSLCMProductPassword`, `Get-vRSLCMLockerPassword`, and `Get-vRSLCMProductDetails`.

Signed-off-by: Jared Burns <jared.burns@broadcom.com>

CHANGELOG.md

@@ -6,15 +6,23 @@
 
 Breaking Change:
 
-- Removes support for Microsoft Windows PowerShell 5.1. Please use Microsoft PowerShell 7.2.0 or later. [GH-159](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/159)
+- Removed support for Microsoft Windows PowerShell 5.1. Please use Microsoft PowerShell 7.2.0 or later. [GH-159](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/159)
 
-Enhancement:
+Bugfix:
 
-- Added 5.1.1.0 to  `Get-PasswordPolicyDefault` and `Get-PasswordPolicyConfig` to support VMware Cloud Foundation 5.1.1. [GH-164](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/164)
+- Fixed missing account lockout policy data for SDDC Manager and vCenter Server. [GH-160](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/160)
 
-Bugfix:
+Enhancement:
 
-- Fix for missing account lockout policy data for SDDC Manager and vCenter Server. [GH-160](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/160)
+- Added 5.1.1.0 to  `Get-PasswordPolicyDefault` and `Get-PasswordPolicyConfig` to support VMware Cloud Foundation 5.1.1. [GH-164](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/164)
+- Added functions to retrieve password policies for each available VMware Aria product deployed in a VMware Cloud Foundation instance. [GH-166](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/166)
+    - `Get-AriaLocalUserAccountLockout` cmdlet to retrieve the password account lockout for Aria product appliance local users.
+    - `Get-AriaLocalUserPasswordComplexity` cmdlet to retrieve the password complexity for Aria product appliance local users.
+    - `Get-AriaLocalUserPasswordExpiration` cmdlet to retrieve the password expiration policy for the specified Aria product appliance local user.
+    - `Publish-AriaLocalUserPasswordPolicy` cmdlet to publish the password policies for Aria product appliance local users.
+    - `Request-AriaLocalUserAccountLockout` cmdlet to retrieve the Aria product appliance password account lockout.
+    - `Request-AriaLocalUserPasswordComplexity` cmdlet to retrieve the Aria product appliance password complexity.
+    - `Request-AriaLocalUserPasswordExpiration` cmdlet to retrieve the Aria product appliance password expiration.
 
 ## v1.7.1
 

VMware.CloudFoundation.PasswordManagement.psd1

@@ -11,7 +11,7 @@
     RootModule        = '.\VMware.CloudFoundation.PasswordManagement.psm1'
 
     # Version number of this module.
-    ModuleVersion     = '1.7.2.1002'
+    ModuleVersion     = '1.7.2.1003'
 
     # Supported PSEditions
     # CompatiblePSEditions = @()

docs/documentation/functions/Get-AriaLocalUserAccountLockout.md

@@ -0,0 +1,197 @@
+# Get-AriaLocalUserAccountLockout
+
+## Synopsis
+
+Retrieves the password account lockout for local users.
+
+## Syntax
+
+```powershell
+Get-AriaLocalUserAccountLockout -vmName <String> -guestUser <String> -guestPassword <String> [-vrni]
+ [-product <String>] [-drift] [-version <String>] [-reportPath <String>] [-policyFile <String>]
+ [<CommonParameters>]
+```
+
+## Description
+
+The `Get-AriaLocalUserAccountLockout` cmdlets retrieves the password account lockout for local users
+
+## Examples
+
+### Example 1
+
+```powershell
+Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra
+```
+
+This example retrieves the VMware Aria Automation password account lockout
+
+### Example 2
+
+
+### Example 3
+
+```powershell
+Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -drift -product vra -reportPath "F:\Reporting" -policyFile "passwordPolicyConfig.json"
+```
+
+This example retrieves the VMware Aria Automation password account lockout and checks the configuration drift using the provided configuration JSON
+
+### Example 4
+
+```powershell
+Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -drift -product vra
+```
+
+This example retrieves the VMware Aria Automation password account lockout and compares the configuration against the product defaults.
+
+
+## Parameters
+
+### -vmName
+
+The virtual machine name.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -guestUser
+
+The guest user name.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -guestPassword
+
+The guest user password.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -vrni
+
+The Aria Operations for Networks flag.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -product
+
+The product to retrieve the password account lockout policy
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -drift
+
+The configuration drift flag.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -version
+
+The product version.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -reportPath
+
+The report path.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -policyFile
+
+The policy file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### Common Parameters
+
+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).