PowerShell ile Active Directory Kullanıcılarını CSV’ye Aktarma

Import-Module ActiveDirectory

$SearchBase = "OU=Istanbul,OU=Users,DC=contoso,DC=com" # örnek

<#
.SYNOPSIS
AD kullanıcılarını seçili alanlarla CSV'ye aktarır.
.DESCRIPTION
OU filtreleme, özel alan seçimi, hata yönetimi ve basit loglama içerir.
.PARAMETER SearchBase
(Opsiyonel) Belirli bir OU DN'i. Boşsa tüm etki alanında arar.
.PARAMETER OutputCsv
Çıktı dosyasının yolu.
.EXAMPLE
.\Export-ADUsers.ps1 -SearchBase "OU=Istanbul,OU=Users,DC=contoso,DC=com" -OutputCsv "C:\Exports\users.csv"
#>

[CmdletBinding()]
param(
[string]$SearchBase,
[Parameter(Mandatory=$false)]
[string]$OutputCsv = "C:\Exports\AD_Users_{0}.csv" -f (Get-Date -Format 'yyyyMMdd_HHmm')
)

try {
# Modül kontrolü
if (-not (Get-Module -ListAvailable -Name ActiveDirectory)) {
throw "ActiveDirectory modülü bulunamadı. RSAT kurulumunu doğrulayın."
}
Import-Module ActiveDirectory -ErrorAction Stop

# Sorgu alanları
$props = @(
'SamAccountName','UserPrincipalName','DisplayName','GivenName','Surname',
'Enabled','Department','Title','telephoneNumber','mail','whenCreated','lastLogonDate'
)

# Filtre ve arama kapsamı
$commonParams = @{
Filter = '*'
Properties = $props
}
if ($SearchBase) { $commonParams.SearchBase = $SearchBase }

Write-Host "Kullanıcılar çekiliyor..."
$users = Get-ADUser @commonParams | Sort-Object -Property DisplayName

# Dışa aktarılacak sütunları seç
$export = $users | Select-Object @{
Name='UserName'; Expression={$_.SamAccountName}
}, @{
Name='UPN'; Expression={$_.UserPrincipalName}
}, @{
Name='DisplayName'; Expression={$_.DisplayName}
}, @{
Name='FirstName'; Expression={$_.GivenName}
}, @{
Name='LastName'; Expression={$_.Surname}
}, @{
Name='Department'; Expression={$_.Department}
}, @{
Name='Title'; Expression={$_.Title}
}, @{
Name='Phone'; Expression={$_.telephoneNumber}
}, @{
Name='Email'; Expression={$_.mail}
}, @{
Name='Enabled'; Expression={$_.Enabled}
}, @{
Name='Created'; Expression={$_.whenCreated}
}, @{
Name='LastLogonDate'; Expression={$_.lastLogonDate}
}




# Klasör yoksa oluştur
$dir = Split-Path -Path $OutputCsv -Parent
if (-not (Test-Path $dir)) { New-Item -Path $dir -ItemType Directory -Force | Out-Null }

# CSV'ye yaz
$export | Export-Csv -Path $OutputCsv -NoTypeInformation -Encoding UTF8

Write-Host "Toplam kullanıcı: $($users.Count)"
Write-Host "CSV oluşturuldu: $OutputCsv"
}
catch {
Write-Warning ("Hata: " + $_.Exception.Message)
throw
}

Get-ADUser -LDAPFilter "(&(objectClass=user)(!(userAccountControl:1.2.840.113556.1.4.803:=2)))" -Properties mail

UserName,UPN,DisplayName,FirstName,LastName,Department,Title,Phone,Email,Enabled,Created,LastLogonDate
jdoe,[email protected],John Doe,John,Doe,IT,System Administrator,+90 212 000 00 00,[email protected],True,2021-05-12,2025-10-20
asmith,[email protected],Ayşe Smith,Ayşe,Smith,Finance,Accountant,+90 212 111 11 11,[email protected],True,2023-02-03,2025-10-22