Export uživatelů z Active Directory
Zjistěte, jak pomocí PowerShell skriptu exportovat uživatele z vaší lokální Active Directory do CSV souboru a hromadně je importovat do Redamp.io.
Spravujete uživatele v lokální (on-premise) Active Directory? Pak je nemusíte do Redamp.io zadávat jednoho po druhém. Náš PowerShell skript je vyexportuje do CSV souboru a ten pak naimportujete do konzole Redamp.io.
Stáhnout ad_users_export.ps1Co skript exportuje
Skript vyexportuje každý povolený uživatelský účet, který má vyplněnou e-mailovou adresu. Zakázané účty a účty bez e-mailu přeskočí.
| Sloupec v CSV | Atribut v Active Directory |
|---|---|
username | sAMAccountName (přihlašovací jméno) |
first_name | givenName |
last_name | sn (příjmení) |
email | mail |
position | title (pracovní pozice) |
Redamp.io přidělí všem importovaným uživatelům běžnou uživatelskou roli. Roli každého uživatele můžete změnit ještě před dokončením importu.
Předpoklady
Doporučujeme spustit skript přímo na serveru Active Directory (řadiči domény). Ten už má vše, co skript potřebuje, takže nemusíte nic instalovat.
- Počítač s Windows připojený do domény.
- Modul Active Directory pro PowerShell. Má ho každý řadič domény. Na ostatní počítače nainstalujte RSAT: Active Directory Domain Services and Lightweight Directory Services Tools.
- Účet, který může číst uživatelské objekty v Active Directory. To umí každý doménový uživatel.
1. Export uživatelů
- Stáhněte skript
ad_users_export.ps1tlačítkem výše. - Otevřete PowerShell ve složce, kam jste skript uložili.
- Spusťte export pro celou doménu:
.\ad_users_export.ps1- Nebo vyexportujte jen jednu organizační jednotku (OU) a OU v ní. Hodí se to třeba tehdy, když máte servisní účty v jiné OU:
.\ad_users_export.ps1 -SearchBase "OU=Employees,DC=company,DC=local"- Skript vytvoří ve stejné složce soubor
ad_users_export.csva vypíše, kolik uživatelů vyexportoval.
Parametry skriptu
| Parametr | Popis | Povinný | Příklad |
|---|---|---|---|
| -SearchBase | Vyexportuje jen uživatele z této OU a jejích podřízených OU. Bez něj skript vyexportuje celou doménu. | Ne | OU=Employees,DC=company,DC=local |
| -Path | Název nebo cesta výstupního CSV souboru. | Ne | C:\Temp\users.csv |
Zjištění cesty k OU
- Otevřete
Active Directory Users and Computers, klikněte naViewa zapněteAdvanced Features. - Otevřete vlastnosti OU a přejděte na kartu
Attribute Editor. - Zkopírujte hodnotu atributu
distinguishedName. To je hodnota pro-SearchBase.
2. Kontrola CSV souboru
Otevřete ad_users_export.csv a projděte řádky. Smažte řádky servisních účtů, sdílených schránek a dalších účtů, které importovat nechcete.
Soubor je v kódování UTF-8, takže jména s diakritikou zůstanou správně.
3. Import souboru do Redamp.io
- Přihlaste se do Redamp.io jako administrátor. (Pokud jste partner, nejprve klikněte na konkrétního klienta, tím otevřete jeho dashboard.)
- Přejděte na
Uživatelé, klikněte na tlačítkoImport uživatelůa vyberte možnost.CSV. - Nahrajte soubor
ad_users_export.csv. Redamp.io přečte názvy sloupců z prvního řádku a typy sloupců nastaví automaticky. Zkontrolujte je v krokuNastavení datových typů na sloupce. - Klikněte na
Kontrola Importu, zkontrolujte uživatele a import dokončete.
Redamp.io může každému importovanému uživateli poslat e-mailovou pozvánku. Uživatel si v ní nastaví heslo a spáruje svá zařízení. Všechny kroky importu najdete v návodu Import uživatelů .
Řešení problémů
Windows skript zablokuje
Windows může zablokovat skript stažený z internetu. Jednou ho odblokujte a spusťte znovu:
Unblock-File .\ad_users_export.ps1Pokud skript stále blokují zásady spouštění (execution policy), povolte skripty jen pro toto okno PowerShellu. Potom skript spusťte znovu:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassChybí modul ActiveDirectory
Chyba The specified module 'ActiveDirectory' was not loaded znamená, že počítač nemá modul Active Directory. Spusťte skript na řadiči domény, nebo nainstalujte RSAT podle sekce Předpoklady .
Skript nenašel žádné uživatele
Skript vypíše No enabled users with an e-mail address were found., když žádný povolený uživatel v doméně nebo v OU nemá vyplněný atribut mail. Zkontrolujte hodnotu -SearchBase a ověřte, že vaši uživatelé mají ve vlastnostech vyplněné pole E-mail.