Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add support for aria #166

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 17 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,18 +8,30 @@ Breaking Change:

- 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:

- 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)
- Enhanced `Get-PasswordPolicyDefault` to show summary in easily readable format. [GH-178](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/178)

Bugfix:

- 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)
- Fixed `VMware.PowerCLI` module name not being added in the required modules list of the manifest file. [GH-170](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/170)
- Fixed `Test-VcfPasswordManagementPrereq` not working while multiple module versions were present. [GH-174](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/174)
- Fixed `Update-VcenterRootPasswordExpiration` to handle empty email string. [GH-177](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/177)

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)
- Enhanced `Get-PasswordPolicyDefault` to show summary in easily readable format. [GH-178](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/178)
- 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 the VMware Aria product appliances local users.
- `Get-AriaLocalUserPasswordComplexity` cmdlet to retrieve the password complexity for the VMware Aria product appliances local users.
- `Get-AriaLocalUserPasswordExpiration` cmdlet to retrieve the password expiration policy for the specified Aria product appliances local user.
- `Request-AriaLocalUserAccountLockout` cmdlet to retrieve the VMware Aria product appliances password account lockout.
- `Request-AriaLocalUserPasswordComplexity` cmdlet to retrieve the VMware Aria product appliances password complexity.
- `Request-AriaLocalUserPasswordExpiration` cmdlet to retrieve the VMware Aria product appliances password expiration.
- `Publish-AriaLocalUserPasswordPolicy` cmdlet to publish the password policies for the VMware Aria product appliances local users.
- `Update-AriaLocalUserAccountLockout` cmdlet to update all password account lockout for the VMware Aria product appliances local users.
- `Update-AriaLocalUserPasswordExpiration` cmdlet to update all password expiration for the VMware Aria product appliances local users.
- `Update-AriaLocalUserPasswordComplexity` cmdlet to update all password complexity for the VMware Aria product appliances local users.


Chore:

- Updated `VMware.PowerCLI` module dependency from v13.1.0 to v13.2.1. [GH-179](/~https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/179)
Expand Down
6 changes: 3 additions & 3 deletions VMware.CloudFoundation.PasswordManagement.psd1
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@

# Module manifest for module 'VMware.CloudFoundation.PasswordManagement
# Generated by: Broadcom
# Generated on: 2024-03-26
# Generated on: 2024-04-01

@{

# Script module or binary module file associated with this manifest.
RootModule = '.\VMware.CloudFoundation.PasswordManagement.psm1'

# Version number of this module.
ModuleVersion = '1.7.2.1006'
ModuleVersion = '1.7.2.1007'

# Supported PSEditions
# CompatiblePSEditions = @()
Expand Down Expand Up @@ -144,4 +144,4 @@
# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
# DefaultCommandPrefix = ''

}
}
6,507 changes: 6,423 additions & 84 deletions VMware.CloudFoundation.PasswordManagement.psm1

Large diffs are not rendered by default.

13 changes: 7 additions & 6 deletions docs/community/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,10 @@ This PowerShell module is the work of many contributors and the project team app
Thank you for your interest in the project. Whether it's a bug report, enhancement, correction, or
additional documentation, we greatly value feedback and contributions from our community.

Name | Title | Role | GitHub |
-------------|------------------------------------------|--------------|--------------------------------------------------------------|
Gary Blake | Senior Staff Solutions Architect, VMware | Maintainer | [:fontawesome-brands-github:](/~https://github.com/GaryJBlake) |
Ryan Johnson | Senior Staff Solutions Architect, VMware | Maintainer | [:fontawesome-brands-github:](/~https://github.com/tenthirtyam)|
Sowjana V | Senior Member of Technical Staff, VMware | Collaborator | [:fontawesome-brands-github:](/~https://github.com/sowjuec) |
Kevin Teng | Senior Member of Technical Staff, VMware | Collaborator | [:fontawesome-brands-github:](/~https://github.com/garlicNova) |
Name | Role | GitHub |
-------------|--------------|------------------------------------------------------------------|
Gary Blake | Maintainer | [:fontawesome-brands-github:](/~https://github.com/GaryJBlake) |
Ryan Johnson | Maintainer | [:fontawesome-brands-github:](/~https://github.com/tenthirtyam) |
Jared Burns | Collaborator | [:fontawesome-brands-github:](/~https://github.com/burnsjared0415) |
Sowjana V | Collaborator | [:fontawesome-brands-github:](/~https://github.com/sowjuec) |
Kevin Teng | Collaborator | [:fontawesome-brands-github:](/~https://github.com/garlicNova) |
193 changes: 193 additions & 0 deletions docs/documentation/functions/Get-AriaLocalUserAccountLockout.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,193 @@
# 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 account lockout policy.

### Example 2

```powershell
Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra -drift -reportPath "F:\Reporting" -policyFile "passwordPolicyConfig.json"
```

This example retrieves the VMware Aria Automation account lockout policy and checks the configuration drift using the provided configuration JSON.

### Example 3

```powershell
Get-Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra -drift
```

This example retrieves the VMware Aria Automation account lockout policy 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 VMware Ariare 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).
Loading