napisz skrypt, który pobiera z serwera Active Directory, ze wskazanego kontenera i…
- User
napisz skrypt, który pobiera z serwera Active Directory, ze wskazanego kontenera i wszystkich podrzędnych kontenerów, dane użytkowników takie jak: Imię, Nazwisko, Ulica
Assistant
Jasne, oto skrypt w PowerShell, który realizuje to zadanie. Skrypt wykorzystuje moduł
ActiveDirectory.Wymagania:
- Uprawnienia: Musisz uruchomić skrypt jako użytkownik, który ma uprawnienia do odczytu obiektów w Active Directory.
- Moduł Active Directory: Musisz mieć zainstalowane Narzędzia zdalnego zarządzania serwerem (RSAT) dla Active Directory Domain Services lub moduł PowerShell Active Directory musi być dostępny na maszynie, z której uruchamiasz skrypt (zazwyczaj jest na kontrolerach domeny lub serwerach z zainstalowanymi RSAT).
Skrypt:
#Requires -Module ActiveDirectory <# .SYNOPSIS Pobiera dane użytkowników AD (Imię, Nazwisko, Ulica) z określonego kontenera i podkontenerów. .DESCRIPTION Skrypt wyszukuje obiekty użytkowników w Active Directory, zaczynając od podanego kontenera (DN). Przeszukuje rekurencyjnie wszystkie podrzędne jednostki organizacyjne (OU). Dla każdego znalezionego użytkownika pobiera jego Imię (GivenName), Nazwisko (Surname) i Ulicę (StreetAddress). Wyniki można wyświetlić na ekranie lub wyeksportować do pliku CSV. .PARAMETER SearchBaseDN Pełna nazwa wyróżniająca (DN) kontenera, od którego ma się rozpocząć wyszukiwanie. Przykład: "OU=Uzytkownicy,OU=Biuro,DC=twojadomena,DC=local" .PARAMETER OutputCsvPath Opcjonalna ścieżka do pliku CSV, do którego zostaną wyeksportowane wyniki. Jeśli nie podano, wyniki zostaną wyświetlone na konsoli. .PARAMETER FilterEnabled Jeśli ustawiony na $true, skrypt pobierze tylko aktywnych (włączonych) użytkowników. Domyślnie pobiera wszystkich. .EXAMPLE .\Get-ADUsersInfo.ps1 -SearchBaseDN "OU=Pracownicy,DC=mojadomena,DC=com" Wyświetla dane Imię, Nazwisko, Ulica dla wszystkich użytkowników w OU=Pracownicy i pod OU. .EXAMPLE .\Get-ADUsersInfo.ps1 -SearchBaseDN "OU=Sprzedaz,DC=firma,DC=int" -OutputCsvPath "C:\temp\sprzedaz_users.csv" -FilterEnabled $true Eksportuje dane Imię, Nazwisko, Ulica dla aktywnych użytkowników z OU=Sprzedaz i pod OU do pliku C:\temp\sprzedaz_users.csv. .NOTES Autor: Twoje Imię/Nazwa Wersja: 1.0 Wymaga modułu Active Directory dla PowerShell. Uruchom jako użytkownik z uprawnieniami do odczytu Active Directory. #> param( [Parameter(Mandatory=$true)] [string]$SearchBaseDN, [Parameter(Mandatory=$false)] [string]$OutputCsvPath, [Parameter(Mandatory=$false)] [bool]$FilterEnabled = $false ) # Sprawdzenie i załadowanie modułu Active Directory Write-Host "Sprawdzanie dostępności modułu Active Directory..." if (-not (Get-Module -Name ActiveDirectory -ErrorAction SilentlyContinue)) { try { Import-Module ActiveDirectory -ErrorAction Stop Write-Host "Moduł Active Directory załadowany pomyślnie." -ForegroundColor Green } catch { Write-Error "Nie można załadować modułu Active Directory. Upewnij się, że narzędzia RSAT są zainstalowane lub moduł jest dostępny. Błąd: $($_.Exception.Message)" # Zakończ skrypt, jeśli moduł jest niezbędny i nie można go załadować return } } else { Write-Host "Moduł Active Directory jest już załadowany." -ForegroundColor Cyan } # Przygotowanie parametrów dla Get-ADUser $getUserParams = @{ SearchBase = $SearchBaseDN Properties = 'GivenName', 'Surname', 'StreetAddress', 'SamAccountName' # Dodajemy SamAccountName dla łatwiejszej identyfikacji ErrorAction = 'Stop' # Zatrzymuj skrypt przy błędach z Get-ADUser } # Dodaj filtr włączonych użytkowników, jeśli parametr jest ustawiony if ($FilterEnabled) { $getUserParams.Filter = 'Enabled -eq $true' Write-Host "Filtrowanie wyników tylko dla aktywnych (włączonych) użytkowników." -ForegroundColor Yellow } else { $getUserParams.Filter = '*' # Pobierz wszystkich użytkowników w zakresie Write-Host "Pobieranie wszystkich użytkowników (również nieaktywnych) w podanym zakresie." -ForegroundColor Yellow } # Zmienne do przechowywania wyników $adUsers = $null $results = $null Write-Host "Rozpoczynanie wyszukiwania użytkowników w kontenerze: '$SearchBaseDN'..." try { # Pobranie użytkowników z AD z użyciem dynamicznych parametrów # Get-ADUser automatycznie przeszukuje podane SearchBase rekurencyjnie $adUsers = Get-ADUser @getUserParams if ($null -eq $adUsers -or $adUsers.Count -eq 0) { Write-Warning "Nie znaleziono żadnych użytkowników pasujących do kryteriów w '$SearchBaseDN' i jego podkontenerach." # Zakończ skrypt, jeśli nie znaleziono użytkowników return } Write-Host "Znaleziono $($adUsers.Count) użytkowników. Przetwarzanie danych..." # Przetworzenie wyników i wybór/zmiana nazw właściwości # Używamy Select-Object z hashtable do tworzenia niestandardowych nazw kolumn $results = $adUsers | Select-Object @{Name='Login';Expression={$_.SamAccountName}}, @{Name='Imię';Expression={$_.GivenName}}, @{Name='Nazwisko';Expression={$_.Surname}}, @{Name='Ulica';Expression={$_.StreetAddress}} # Obsługa wyników - wyświetlanie lub eksport do CSV if (-not [string]::IsNullOrWhiteSpace($OutputCsvPath)) { # Sprawdzenie czy katalog docelowy istnieje, jeśli nie to próba jego utworzenia $OutputDirectory = Split-Path -Path $OutputCsvPath -Parent if (-not (Test-Path -Path $OutputDirectory -PathType Container)) { Write-Host "Katalog docelowy '$OutputDirectory' nie istnieje. Próba utworzenia..." try { New-Item -Path $OutputDirectory -ItemType Directory -Force -ErrorAction Stop | Out-Null Write-Host "Katalog '$OutputDirectory' utworzony pomyślnie." -ForegroundColor Green } catch { Write-Error "Nie można utworzyć katalogu '$OutputDirectory'. Błąd: $($_.Exception.Message)" # Zakończ, jeśli nie można utworzyć katalogu return } } # Eksport do pliku CSV z kodowaniem UTF8 dla polskich znaków try { $results | Export-Csv -Path $OutputCsvPath -NoTypeInformation -Encoding UTF8 -ErrorAction Stop Write-Host "Wyniki zostały pomyślnie wyeksportowane do pliku: '$OutputCsvPath'" -ForegroundColor Green } catch { Write-Error "Nie udało się wyeksportować wyników do pliku '$OutputCsvPath'. Sprawdź uprawnienia i dostępność ścieżki. Błąd: $($_.Exception.Message)" } } else { # Wyświetlanie na konsoli, jeśli nie podano ścieżki pliku Write-Host "Wyniki wyszukiwania:" $results | Format-Table -AutoSize } } catch [Microsoft.ActiveDirectory.Management.ADIdentityNotFoundException] { Write-Error "Błąd krytyczny: Podany kontener '$SearchBaseDN' nie został znaleziony w Active Directory." } catch [Microsoft.ActiveDirectory.Management.ADServerDownException] { Write-Error "Błąd krytyczny: Serwer Active Directory jest niedostępny. Sprawdź połączenie sieciowe i dostępność kontrolerów domeny." } catch [Microsoft.ActiveDirectory.Management.ADBadDNComparisonException] { Write-Error "Błąd krytyczny: Nieprawidłowy format DN kontenera '$SearchBaseDN'. Sprawdź składnię." } catch { # Ogólny blok catch dla innych nieoczekiwanych błędów Write-Error "Wystąpił nieoczekiwany błąd podczas pobierania danych z Active Directory. Szczegóły: $($_.Exception.Message)" # Można dodać więcej szczegółów dla debugowania: # Write-Error $_.ScriptStackTrace } Write-Host "Skrypt zakończył działanie."Jak używać:
- Zapisz skrypt: Zapisz powyższy kod w pliku, na przykład
Get-ADUsersInfo.ps1. - Uruchom PowerShell: Otwórz konsolę PowerShell jako administrator (lub z uprawnieniami do AD). Może być konieczne dostosowanie polityki wykonywania skryptów, jeśli jeszcze tego nie zrobiłeś (np.
Set-ExecutionPolicy RemoteSigned). - Wywołaj skrypt:
- Aby wyświetlić wyniki na ekranie:
(Zamień.\Get-ADUsersInfo.ps1 -SearchBaseDN "OU=NazwaTwojejOU,DC=twojaDomena,DC=com"OU=NazwaTwojejOU,DC=twojaDomena,DC=comna rzeczywistą ścieżkę DN kontenera w Twoim AD). - Aby wyeksportować wyniki do pliku CSV:
.\Get-ADUsersInfo.ps1 -SearchBaseDN "OU=NazwaTwojejOU,DC=twojaDomena,DC=com" -OutputCsvPath "C:\Sciezka\Do\Pliku\uzytkownicy.csv" - Aby pobrać tylko aktywnych użytkowników i wyeksportować do CSV:
.\Get-ADUsersInfo.ps1 -SearchBaseDN "OU=NazwaTwojejOU,DC=twojaDomena,DC=com" -OutputCsvPath "C:\Sciezka\Do\Pliku\aktywni_uzytkownicy.csv" -FilterEnabled $true
- Aby wyświetlić wyniki na ekranie:
Skrypt jest wyposażony w podstawową obsługę błędów i informacje zwrotne dla użytkownika.
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.