1. OG_AD-User

    Article: AN0001776Updated: 20.05.2020

    Tato funkce vrátí seznam uživatelů s danými vlastnostmi z LDAP (Microsoft Active Directory) dle konfigurace.

    Hlavní předpoklady pro použití

     

    Předpoklad Popis

    Module Active Directory PowerShell Microsoft

    Při komunikaci s externími systémy využívajícími vykonání Powershell příkazů externím systémem je třeba na externím systému povolit remoting.
    Remote Differential Compression Pro vyčtení informací o uživatelích z LDAP je třeba na serveru vykonávajícím tuto funkcionalitu povolit tuto funkci systému Windows.
    AD DS and AD LDS Tools Pro vyčtení informací o uživatelích z LDAP je třeba na serveru vykonávajícím tuto funkcionalitu povolit tuto funkci systému Windows.
    Powershell v3 Microsoft Powershell verze 3 nebo vyšší.

    Popis

    Funkce vytvoří textový soubor obsahující informace o uživatelích dle konfigurace. Soubor obsahuje následující informace.

     

    Název hlavičky sloupce Popis
    Login Login uživatele. Např. altman
    LoginWithDomain Login uživatele včetně domény. Např. OBJECTGEARS\altman
    Displayname Zobrazované jméno uživatele.
    Firstname Křestní jméno uživatele.
    Lastname Příjmení uživatele.
    Email Email uživatele.
    Enabled (Yes/No) Informace, zda je účet uživatele v systému Windows aktivován nebo blokován.
    Phone Telefonní číslo uživatele.
    Fax Fax číslo uživatele.
    SID SID uživatele.
    Description Popis uživatele.
    Office Údaj o umístění uživatele (kancelář).
    PasswordExpired Informace, zda uživateli vypršelo heslo.

    Parametry

    Níže uvedené parametry uveďte v souboru og_configuration.ps1 (obecné parametry sdílené s jinými funkcemi) nebo v souboru OG_AD-User.config (konkrétní parametry této funkce). Konfigurace parametrů je obecně popsána v dokumentaci programu Piklo.

     

    Parametr Popis Příklad
    [string]$LogFile Cesta k souboru, do nějž bude funkce logovat. [string]$LogFile = "\\servername\OGoutput\AD-Users\LogFile.txt"
    [string]$OutFile Cesta k výstupnímu souboru s daty uživatelů.

    [string]$OutFile = "\\servername\OGoutput\AD-Users\OutFile.txt"

    [string]$OutFileEncoding Kódování výstupního souboru. Možné volby jsou "UTF8", "Unicode" a "DEFAULT". Hodnota "DEFAULT" způsobí vytvoření souboru v kódování ANSI.

    [string]$OutFileEncoding = "UTF8"

    [string]$Delimiter Oddělovač hodnot v záznamech. Možné hodnoty jsou: "t" - tabulator, ";" - středník a "," - čárka

    [string]$Delimiter = "t"

    [string]$HeaderOutFile Určuje, zda má výstupní soubor obsahovat hlavičku s názvy sloupců ("1") nebo ne ("0").

    [string]$HeaderOutFile = "1"

    [string]$SkipNullEmailorDisplayName Určuje, zda do výstupního souboru mají být zařazeny pouze záznamy uživatelů, kteří mají vyplněn DisplayName a Email ("True") nebo všechny záznamy uživatelů ("False").

    [string]$SkipNullEmailorDisplayName = "True"

    Pokud chcete vytvořený soubor použít k importu uživatelů do ObjectGears, nastavte parametr SkipNullEmailorDisplayName na hodnotu "True".

    Volání

    Funkce je volána pomocí programu Piklo, který je součástí balíku ObjectGears, ze skriptu ObjectGears. Výsledek volání je třeba přiřadit do proměnné, se kterou lze ve skriptu dále pracovat.

    a = OG.Process.RunPiklo('OG_AD-User','-type C')

×