feat: add support for Aria Products

Created functions to retrieve all Aria Products installed in SDDC environment, functions rely on PVS functions Get-vRSLCMProductPassword, Get-vRSLCMLockerPassword, and Get-vRSLCMProductDetails

Signed-off-by: Jared Burns <[email protected]>

Author: burnsjared0415

CHANGELOG.md

@@ -11,11 +11,17 @@ Breaking Change:
 Enhancement:
 
 - 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 new functions for getting aria products passwords.
 
 Bugfix:
 
 - 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)
 
+Enchancements:
+
+- Created functions to retrieve all Aria Products installed in SDDC environment, functions rely on PVS functions Get-vRSLCMProductPassword, Get-vRSLCMLockerPassword, and Get-vRSLCMProductDetails
+[GH-166] (https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/166)
+
 ## v1.7.1
 
 > Release Date: 2024-01-30

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 = @()

VMware.CloudFoundation.PasswordManagement.psm1

@@ -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).