New-RandomADUser.psm1
|
#Requires -Modules ActiveDirectory # Function to generate random Active Directory users function New-RandomADUser { [CmdletBinding(SupportsShouldProcess)] param( [Parameter(Mandatory = $true, HelpMessage = "The domain name (e.g., contoso.com)")] [string]$Domain, [Parameter(Mandatory = $true, HelpMessage = "The organizational unit (OU) to create users in (e.g., 'OU=Users,DC=contoso,DC=com')")] [string]$OU, [Parameter(Mandatory = $false, HelpMessage = "The number of users to generate (default: 1)")] [int]$Count = 1, [Parameter(Mandatory = $false, HelpMessage = "Prefix for usernames (e.g., 'test')")] [string]$Prefix = "" ) # Function to generate a random password function Get-RandomPassword { $passwordChars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!@#$%^&*()" $passwordLength = 16 $password = -join ($passwordChars | Get-Random -Count $passwordLength) return $password } # Function to generate a random name function Get-RandomName { $firstNames = Get-Content -Path "$PSScriptRoot\files\firstnames.txt" $lastNames = Get-Content -Path "$PSScriptRoot\files\lastnames.txt" $firstName = Get-Random -InputObject $firstNames $lastName = Get-Random -InputObject $lastNames return @{ FirstName = $firstName; LastName = $lastName } } # Main loop to create users for ($i = 0; $i -lt $Count; $i++) { $randomName = Get-RandomName $firstName = $randomName.FirstName $lastName = $randomName.LastName $username = "$Prefix$($firstName.ToLower()).$($lastName.ToLower())" $userPrincipalName = "$username@$Domain" $password = Get-RandomPassword if ($PSCmdlet.ShouldProcess("$Domain\$username", "Create Active Directory User")) { try { New-ADUser -Name "$firstName $lastName" ` -GivenName $firstName ` -Surname $lastName ` -SamAccountName $username ` -UserPrincipalName $userPrincipalName ` -AccountPassword (ConvertTo-SecureString $password -AsPlainText -Force) ` -Path $OU ` -Enabled $true ` -ChangePasswordAtLogon $true ` -ErrorAction Stop Write-Verbose "Created user: $username (Password: $password)" Write-Output "User '$username' created successfully." } catch { Write-Error "Failed to create user '$username': $($_.Exception.Message)" } } } } # Export the function Export-ModuleMember -Function New-RandomADUser |