PowerShell et Active Directory : exemples Get-ADUser
Recherche d'utilisateurs, comptes expirés, groupes, exports CSV et photo avec les cmdlets ActiveDirectory.
Une collection d'exemples Get-ADUser et d'autres cmdlets Active Directory (module ActiveDirectory, fourni avec RSAT).
Rechercher des utilisateurs
# One user by sAMAccountName, with extra properties
Get-ADUser -Filter {samAccountName -eq "jdoe"} -Properties sAMAccountName,Title,manager
# Parameter help
help Get-ADUser -Parameter identity
# Users whose name starts with Joe
Get-ADUser -Filter {name -like "Joe*"}
# Wildcards on name
Get-ADUser -Filter {name -like 'j*w*'}
Filtrer côté serveur avec -Filter est plus efficace que tout récupérer puis filtrer dans le pipeline. Comparaison :
Get-ADUser -Filter * | Where-Object {$_.GivenName -like 'j*' -and $_.Surname -like 'W*'}
Measure-Command {Get-ADUser -Filter * | Where-Object {$_.GivenName -like 'j*' -and $_.Surname -like 'W*'}}
Compter et lister les comptes
# Total number of accounts
Get-ADUser -Filter {SamAccountName -like "*"} | Measure-Object
# Active (enabled) accounts
Get-ADUser -Filter {Enabled -eq "True"} | Select-Object SamAccountName,Name,Surname,GivenName | Format-Table
# Enabled accounts whose password has expired
Get-ADUser -Filter {Enabled -eq $True} -Properties passwordExpired | Where-Object {$_.PasswordExpired}
# Users who have not changed their password in the last 90 days
$90_Days = (Get-Date).AddDays(-90)
Get-ADUser -Filter {(passwordlastset -le $90_days)}
Groupes
# All groups a user belongs to
Get-ADPrincipalGroupMembership username | Select-Object name
# Same, from the memberOf attribute
Get-ADUser jdoe -Properties memberof | Select-Object -ExpandProperty memberof
# Add a user to a group
Add-ADGroupMember -Identity "GroupName" -Member username
Export CSV
Comptes actifs ayant une adresse e-mail :
Get-ADUser -Filter {(mail -ne "null") -and (Enabled -eq "true")} -Properties Surname,GivenName,mail | Select-Object Name,Surname,GivenName,mail | Format-Table
Export du carnet d'adresses, importable dans des clients de messagerie comme Outlook ou Thunderbird :
Get-ADUser -Filter {(mail -ne "null") -and (Enabled -eq "true")} -Properties Surname,GivenName,mail | Select-Object Name,Surname,GivenName,mail | Export-Csv -NoTypeInformation -Encoding utf8 -Delimiter "," $env:temp\address_list.csv
Pour une liste de comptes dans un fichier CSV (colonne user), récupérer la société de chaque utilisateur et l'enregistrer dans un autre CSV ouvrable dans Excel :
Import-Csv c:\ps\users_list.csv | ForEach-Object {
Get-ADUser -Identity $_.user -Properties Name, Company |
Select-Object Name, Company |
Export-Csv c:\ps\users_ad_list.csv -Append -Encoding UTF8
}
Photo
Enregistrer l'attribut thumbnailPhoto d'un utilisateur dans un fichier JPEG :
$usr = Get-ADUser jdoe -Properties thumbnailPhoto
$usr.thumbnailPhoto | Set-Content jdoe.jpg -Encoding byte
Comptes locaux et SID
wmic useraccount get name,sid
Remarques
-Encoding byteconvient à Windows PowerShell 5.1 ; dans PowerShell 7, utiliser-AsByteStream.wmicest obsolète dans les versions récentes de Windows ;Get-LocalUserrenvoie aussi le SID.