Guida agli script di PowerShell: Visualizzare i membri di una OU in Active Directory

Punti chiave

• Conoscenza di PowerShell: L’utilizzo di PowerShell è fondamentale per una gestione efficiente di AD, in particolare per la gestione degli account utente nelle OU.
• Strutturazione dello script: La comprensione dei blocchi di inizio, processo e fine dello script è fondamentale per il suo funzionamento e per le potenziali personalizzazioni.
• Accesso amministrativo: L’esecuzione dello script per visualizzare i membri di una OU con privilegi amministrativi è necessaria per accedere e modificare i dati AD.
• Flessibilità dei parametri: Lo script per visualizzare i membri di una OU può essere adattato a vari ambienti AD modificando i parametri OU e CustomField.
• L’efficienza supera la tradizione: Lo scripting PowerShell offre un approccio più efficiente e automatizzabile rispetto ai metodi tradizionali di gestione dell’AD.
• Considerazioni sulla sicurezza: Garantire un accesso limitato allo script per visualizzare i membri di una OU è fondamentale per la sua capacità di recuperare informazioni sensibili dell’utente.
• Adattabilità ed estensione: La natura modulare dello script per visualizzare i membri di una OU consente di modificarlo facilmente per soddisfare le esigenze specifiche dell’infrastruttura AD.
• Strumenti complementari: L’integrazione di script PowerShell con piattaforme come NinjaOne può migliorare la gestione IT complessiva e l’efficienza operativa.

La gestione di Active Directory (AD) è un aspetto fondamentale dell’amministrazione di rete in molti ambienti aziendali. Quando gli amministratori sono alle prese con le complessità della gestione degli account utente e delle unità organizzative (OU), PowerShell emerge come uno strumento affidabile, che offre flessibilità ed efficienza. In questo articolo analizzeremo uno script PowerShell progettato per estrarre i membri di una OU da AD, un’operazione fondamentale per una gestione efficace delle directory.

Background

Active Directory, la pietra angolare della gestione delle identità nelle reti Windows, richiede spesso agli amministratori di gestire un gran numero di account utente organizzati in OU. Lo script in questione fornisce un approccio semplificato per recuperare i dati degli utenti da specifiche OU, un’attività comunemente utilizzata dai professionisti IT e dai Managed Service Provider (MSP). Questo script non solo semplifica la gestione degli utenti, ma migliora anche le capacità di monitoraggio e auditing in un ambiente AD.

Lo script per visualizzare i membri di una OU:

#Requires -Version 4.0

<#
.SYNOPSIS
    Gets the members of an OU from AD.
.DESCRIPTION
    Gets the members of an OU(Organizational Unit) from AD(Active Directory) and can save the results to a Custom Field.

PARAMETER: -OU "Test"
    A brief explanation of the parameter.
.EXAMPLE
    -OU "Test"

    OU=Test,DC=something,DC=local 
    -----------------------------   
    [email protected]

PARAMETER: -OU "Test" -CustomField "TestOU"
    A brief explanation of the parameter.
.EXAMPLE
    -OU "Test" -CustomField "TestOU"

    OU=Test,DC=something,DC=local
    ----------------------------- 
    [email protected]

.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows Server 2012 R2 (Domain Controller's Only)
    Release Notes: Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>

[CmdletBinding()]
param (
    [Parameter()]
    [string]$OU,
    [string]$CustomField
)

begin {
    function Test-IsElevated {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        $p = New-Object System.Security.Principal.WindowsPrincipal($id)
        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)
    }

    if (-not (Get-Module -Name ActiveDirectory -ListAvailable)) { 
        Write-Error "RSAT is required to get the membership. Please run this on a domain controller or on a machine with RSAT installed." 
        exit 1
    }
}
process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }

    if ($env:OU -and $env:OU -notlike "null") {
        $OU = $env:OU
    }

    if ($env:CustomField -and $env:CustomField -notlike "null") {
        $CustomField = $env:CustomField
    }

    $Report = New-Object System.Collections.Generic.List[string]

    try {
        $OUPaths = Get-ADOrganizationalUnit -Filter * | Where-Object { $_.DistinguishedName -like "OU=$OU*" } | Select-Object -ExpandProperty DistinguishedName
        $OUPaths | ForEach-Object {
            $Report.Add("`n$_")

            $TitleLength = $_.Length
            $i = 1
            $Title = $Null
            while($i -le $TitleLength){
                $Title = "$Title-"
                $i++
            }
            $Report.Add($Title)

            Get-ADUser -Filter * -SearchBase $_ -ErrorAction SilentlyContinue | Select-Object -ExpandProperty UserPrincipalName -ErrorAction SilentlyContinue | ForEach-Object { $Report.Add("$_") }
        }
    }
    catch {
        Write-Error $_
        exit 1
    }

    $Report | Write-Host

    if ($CustomField) {
        Ninja-Property-Set -Name $CustomField -Value $($Report | Out-String)
    }
}
end {
    
    
    
}

 

Analisi dettagliata dello script per visualizzare i membri di una OU

Lo script per visualizzare i membri di una OU inizia con un controllo obbligatorio della versione, che assicura la compatibilità con PowerShell 4.0 o superiore. È strutturato in tre parti: inizio, processo e fine, i blocchi standard di uno script PowerShell.

• Blocco “inizio”: In questo blocco si effettua un controllo dei prerequisiti per il modulo Active Directory, fondamentale per le operazioni AD dello script. Una funzione di controllo dell’elevazione, Test-IsElevated, assicura che lo script per visualizzare i membri di una OU venga eseguito con privilegi amministrativi, fondamentali per accedere ai dati AD.
• Blocco “processo”: Le operazioni principali avvengono qui. Lo script per visualizzare i membri di una OU accetta due parametri: OU per specificare l’Unità organizzativa e CustomField per la personalizzazione opzionale dell’output dei dati. Si adatta dinamicamente alle variabili d’ambiente per questi parametri, se presenti. Lo script genera quindi un elenco ($Report) per memorizzare l’output. Utilizzando il cmdlet Get-ADOrganizationalUnit, lo script recupera i nomi distinti di tutte le OU che corrispondono al parametro OU specificato. Per ogni OU trovata, i dettagli dell’utente (UserPrincipalName) al suo interno vengono recuperati con Get-ADUser e aggiunti all’elenco dei report.
• Blocco “fine”: Utilizzato principalmente per le operazioni finali e di pulizia, in questo script per visualizzare i membri di una OU è lasciato vuoto per indicare che non ci sono azioni specifiche da effettuare al completamento dello script.

Casi d’uso potenziali

Immagina che un amministratore IT debba verificare regolarmente gli account utente in specifiche OU. Utilizzando questo script per visualizzare i membri di una OU, può generare rapidamente un elenco di tutti gli utenti delle OU interessate, facilitando l’auditing e i controlli di conformità.

Confronti

Tradizionalmente, queste attività venivano eseguite manualmente attraverso la console Users and Computers di AD o utilizzando query LDAP di base. L’approccio PowerShell, come illustrato da questo script, offre una soluzione più flessibile e gestibile via script che può essere automatizzata e integrata in flussi di lavoro più ampi.

Domande frequenti

• È possibile modificare lo script per visualizzare i membri di una OU per strutture AD diverse?
  Assolutamente, lo script per visualizzare i membri di una OU può essere adattato a diverse configurazioni AD modificando il parametro OU.
• È necessario eseguire lo script per visualizzare i membri di una OU con i privilegi di amministratore?
  Sì, per accedere ai dati AD è obbligatorio l’accesso a livello di amministratore.
• Lo script per visualizzare i membri di una OU può gestire più OU contemporaneamente?
  Nella sua forma attuale, è progettato per una OU alla volta, ma può essere esteso per gestire più OU.

Implicazioni

Se da un lato lo script per visualizzare i membri di una OU migliora l’efficienza, dall’altro c’è da considerare l’aspetto della sicurezza. Assicurarsi che solo il personale autorizzato abbia accesso all’esecuzione di uno script di questo tipo è fondamentale, poiché opera con informazioni sensibili dell’utente.

Raccomandazioni

• Esegui sempre lo script per visualizzare i membri di una OU in un ambiente controllato.
• Aggiorna regolarmente lo script per visualizzare i membri di una OU per adattarlo alle modifiche dell’infrastruttura AD.
• Implementa un sistema di logging per tracciare l’uso e l’output dello script per visualizzare i membri di una OU.

Considerazioni finali

Nel campo dell’IT, efficienza e automazione sono fondamentali. Gli script di PowerShell, come quello qui descritto per visualizzare i membri di una OU, svolgono un ruolo fondamentale nella semplificazione delle attività di AD. Strumenti come NinjaOne integrano tali script fornendo una piattaforma unificata per la gestione delle operazioni IT, e semplificando ulteriormente le sfide affrontate dai professionisti IT.