Skip to content

Commit 4caafd5

Browse files
feat: add support for aria (vmware#166)
Adds functions to retrieve password policies for each available VMware Aria product deployed in a VMware Cloud Foundation instance. Signed-off-by: Jared Burns <[email protected]> Co-authored-by: Ryan Johnson <[email protected]>
1 parent c8f1c79 commit 4caafd5

File tree

90 files changed

+8920
-203
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

90 files changed

+8920
-203
lines changed

Diff for: CHANGELOG.md

+17-5
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,30 @@ Breaking Change:
88

99
- 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)
1010

11-
Enhancement:
12-
13-
- 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)
14-
- 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)
15-
1611
Bugfix:
1712

1813
- 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)
1914
- 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)
2015
- 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)
2116
- Fixed `Update-VcenterRootPasswordExpiration` to handle empty email string. [GH-177](https://github.com/vmware/powershell-module-for-vmware-cloud-foundation-password-management/pull/177)
2217

18+
Enhancement:
19+
20+
- 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)
21+
- 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)
22+
- 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)
23+
- `Get-AriaLocalUserAccountLockout` cmdlet to retrieve the password account lockout for the VMware Aria product appliances local users.
24+
- `Get-AriaLocalUserPasswordComplexity` cmdlet to retrieve the password complexity for the VMware Aria product appliances local users.
25+
- `Get-AriaLocalUserPasswordExpiration` cmdlet to retrieve the password expiration policy for the specified Aria product appliances local user.
26+
- `Request-AriaLocalUserAccountLockout` cmdlet to retrieve the VMware Aria product appliances password account lockout.
27+
- `Request-AriaLocalUserPasswordComplexity` cmdlet to retrieve the VMware Aria product appliances password complexity.
28+
- `Request-AriaLocalUserPasswordExpiration` cmdlet to retrieve the VMware Aria product appliances password expiration.
29+
- `Publish-AriaLocalUserPasswordPolicy` cmdlet to publish the password policies for the VMware Aria product appliances local users.
30+
- `Update-AriaLocalUserAccountLockout` cmdlet to update all password account lockout for the VMware Aria product appliances local users.
31+
- `Update-AriaLocalUserPasswordExpiration` cmdlet to update all password expiration for the VMware Aria product appliances local users.
32+
- `Update-AriaLocalUserPasswordComplexity` cmdlet to update all password complexity for the VMware Aria product appliances local users.
33+
34+
2335
Chore:
2436

2537
- 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)

Diff for: VMware.CloudFoundation.PasswordManagement.psd1

+3-3
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@
33

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

88
@{
99

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

1313
# Version number of this module.
14-
ModuleVersion = '1.7.2.1006'
14+
ModuleVersion = '1.7.2.1007'
1515

1616
# Supported PSEditions
1717
# CompatiblePSEditions = @()
@@ -144,4 +144,4 @@
144144
# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
145145
# DefaultCommandPrefix = ''
146146

147-
}
147+
}

Diff for: VMware.CloudFoundation.PasswordManagement.psm1

+6,423-84
Large diffs are not rendered by default.

Diff for: docs/community/index.md

+7-6
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,10 @@ This PowerShell module is the work of many contributors and the project team app
55
Thank you for your interest in the project. Whether it's a bug report, enhancement, correction, or
66
additional documentation, we greatly value feedback and contributions from our community.
77

8-
Name | Title | Role | GitHub |
9-
-------------|------------------------------------------|--------------|--------------------------------------------------------------|
10-
Gary Blake | Senior Staff Solutions Architect, VMware | Maintainer | [:fontawesome-brands-github:](https://github.com/GaryJBlake) |
11-
Ryan Johnson | Senior Staff Solutions Architect, VMware | Maintainer | [:fontawesome-brands-github:](https://github.com/tenthirtyam)|
12-
Sowjana V | Senior Member of Technical Staff, VMware | Collaborator | [:fontawesome-brands-github:](https://github.com/sowjuec) |
13-
Kevin Teng | Senior Member of Technical Staff, VMware | Collaborator | [:fontawesome-brands-github:](https://github.com/garlicNova) |
8+
Name | Role | GitHub |
9+
-------------|--------------|------------------------------------------------------------------|
10+
Gary Blake | Maintainer | [:fontawesome-brands-github:](https://github.com/GaryJBlake) |
11+
Ryan Johnson | Maintainer | [:fontawesome-brands-github:](https://github.com/tenthirtyam) |
12+
Jared Burns | Collaborator | [:fontawesome-brands-github:](https://github.com/burnsjared0415) |
13+
Sowjana V | Collaborator | [:fontawesome-brands-github:](https://github.com/sowjuec) |
14+
Kevin Teng | Collaborator | [:fontawesome-brands-github:](https://github.com/garlicNova) |
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,193 @@
1+
# Get-AriaLocalUserAccountLockout
2+
3+
## Synopsis
4+
5+
Retrieves the password account lockout for local users.
6+
7+
## Syntax
8+
9+
```powershell
10+
Get-AriaLocalUserAccountLockout -vmName <String> -guestUser <String> -guestPassword <String> [-vrni]
11+
[-product <String>] [-drift] [-version <String>] [-reportPath <String>] [-policyFile <String>]
12+
[<CommonParameters>]
13+
```
14+
15+
## Description
16+
17+
The `Get-AriaLocalUserAccountLockout` cmdlets retrieves the password account lockout for local users.
18+
19+
## Examples
20+
21+
### Example 1
22+
23+
```powershell
24+
Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra
25+
```
26+
27+
This example retrieves the VMware Aria Automation account lockout policy.
28+
29+
### Example 2
30+
31+
```powershell
32+
Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra -drift -reportPath "F:\Reporting" -policyFile "passwordPolicyConfig.json"
33+
```
34+
35+
This example retrieves the VMware Aria Automation account lockout policy and checks the configuration drift using the provided configuration JSON.
36+
37+
### Example 3
38+
39+
```powershell
40+
Get-Get-AriaLocalUserAccountLockout -vmName sfo-vra01 -guestUser root -guestPassword VMw@re1! -product vra -drift
41+
```
42+
43+
This example retrieves the VMware Aria Automation account lockout policy and compares the configuration against the product defaults.
44+
45+
## Parameters
46+
47+
### -vmName
48+
49+
The virtual machine name.
50+
51+
```yaml
52+
Type: String
53+
Parameter Sets: (All)
54+
Aliases:
55+
56+
Required: True
57+
Position: Named
58+
Default value: None
59+
Accept pipeline input: False
60+
Accept wildcard characters: False
61+
```
62+
63+
### -guestUser
64+
65+
The guest user name.
66+
67+
```yaml
68+
Type: String
69+
Parameter Sets: (All)
70+
Aliases:
71+
72+
Required: True
73+
Position: Named
74+
Default value: None
75+
Accept pipeline input: False
76+
Accept wildcard characters: False
77+
```
78+
79+
### -guestPassword
80+
81+
The guest user password.
82+
83+
```yaml
84+
Type: String
85+
Parameter Sets: (All)
86+
Aliases:
87+
88+
Required: True
89+
Position: Named
90+
Default value: None
91+
Accept pipeline input: False
92+
Accept wildcard characters: False
93+
```
94+
95+
### -vrni
96+
97+
The VMware Ariare Aria Operations for Networks flag.
98+
99+
```yaml
100+
Type: SwitchParameter
101+
Parameter Sets: (All)
102+
Aliases:
103+
104+
Required: False
105+
Position: Named
106+
Default value: False
107+
Accept pipeline input: False
108+
Accept wildcard characters: False
109+
```
110+
111+
### -product
112+
113+
The product to retrieve the password account lockout policy.
114+
115+
```yaml
116+
Type: String
117+
Parameter Sets: (All)
118+
Aliases:
119+
120+
Required: False
121+
Position: Named
122+
Default value: None
123+
Accept pipeline input: False
124+
Accept wildcard characters: False
125+
```
126+
127+
### -drift
128+
129+
The configuration drift flag.
130+
131+
```yaml
132+
Type: SwitchParameter
133+
Parameter Sets: (All)
134+
Aliases:
135+
136+
Required: False
137+
Position: Named
138+
Default value: False
139+
Accept pipeline input: False
140+
Accept wildcard characters: False
141+
```
142+
143+
### -version
144+
145+
The product version.
146+
147+
```yaml
148+
Type: String
149+
Parameter Sets: (All)
150+
Aliases:
151+
152+
Required: False
153+
Position: Named
154+
Default value: None
155+
Accept pipeline input: False
156+
Accept wildcard characters: False
157+
```
158+
159+
### -reportPath
160+
161+
The report path.
162+
163+
```yaml
164+
Type: String
165+
Parameter Sets: (All)
166+
Aliases:
167+
168+
Required: False
169+
Position: Named
170+
Default value: None
171+
Accept pipeline input: False
172+
Accept wildcard characters: False
173+
```
174+
175+
### -policyFile
176+
177+
The policy file.
178+
179+
```yaml
180+
Type: String
181+
Parameter Sets: (All)
182+
Aliases:
183+
184+
Required: False
185+
Position: Named
186+
Default value: None
187+
Accept pipeline input: False
188+
Accept wildcard characters: False
189+
```
190+
191+
### Common Parameters
192+
193+
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).

0 commit comments

Comments
 (0)