Come trovare e memorizzare le dimensioni dei profili utente di Windows con PowerShell

PowerShell ha innegabilmente rivoluzionato il modo in cui i professionisti IT gestiscono i sistemi Windows, automatizzano le attività più banali e approfondiscono la diagnostica del sistema. Oggi parliamo in modo dettagliato di uno script ben realizzato progettato per valutare le dimensioni dei profili utente su Windows, uno strumento fondamentale per gli amministratori di sistema e i Managed Service Provider (MSP).

Background

Con l’aumento dei big data e di applicazioni sempre più sofisticate, la gestione dello storage e un utilizzo efficiente dello spazio su disco sono diventati fondamentali. I professionisti IT e gli MSP sono spesso alle prese con i problemi derivati dall’accumulo di grandi quantità di dati da parte degli utenti, a volte archiviati in modo inconsapevole. Questo script risolve questo problema consentendo ai professionisti IT di determinare rapidamente le dimensioni dei profili utente, garantendo una gestione ottimale dello storage e l’integrità del sistema.

Lo script per trovare le dimensioni dei profili utente in ambiente Windows

#Requires -Version 5.1

<#
.SYNOPSIS
    Updates a Custom Field with the total size of all User Profiles.
    If the Max parameter is specified then it will return an exit code of 1
     for any profile being over that Max threshold in GB.
.DESCRIPTION
    Updates a Custom Field with the total size of all User Profiles.
    If the Max parameter is specified then it will return an exit code of 1
     for any profile being over that Max threshold in GB.
.EXAMPLE
     -Max 60
    Returns and exit code of 1 if any profile is over 60GB
.EXAMPLE
     -CustomField "Something"
    Specifies the name of the custom field to update.
.EXAMPLE
    No Parameter needed.
    Uses the default custom field name: TotalUsersProfileSize
.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2016
    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()]
    [Alias("MaxSize", "Size", "ms", "m", "s")]
    [Double]
    $Max,
    [Parameter()]
    [Alias("Custom", "Field", "cf", "c", "f")]
    [String]
    $CustomField = "TotalUsersProfileSize"
)

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)
    }
    function Format-FileSize {
        param($Length)
        switch ($Length) {
            { $_ / 1TB -gt 1 } { "$([Math]::Round(($_ / 1TB),2)) TB"; break }
            { $_ / 1GB -gt 1 } { "$([Math]::Round(($_ / 1GB),2)) GB"; break }
            { $_ / 1MB -gt 1 } { "$([Math]::Round(($_ / 1MB),2)) MB"; break }
            { $_ / 1KB -gt 1 } { "$([Math]::Round(($_ / 1KB),2)) KB"; break }
            Default { "$_ Bytes" }
        }
    }
}
process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }

    $Profiles = Get-ChildItem -Path "C:Users"
    $ProfileSizes = $Profiles | ForEach-Object {
        [PSCustomObject]@{
            Name   = $_.BaseName
            Length = Get-ChildItem -Path $_.FullName -Recurse -Force -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue | Select-Object -Property Sum -ExpandProperty Sum
        }
    }
    $Largest = $ProfileSizes | Sort-Object -Property Length -Descending | Select-Object -First 1

    $Size = $ProfileSizes | Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue | Select-Object -Property Sum -ExpandProperty Sum

    $FormattedSize = Format-FileSize -Length $Size

    $AllProfiles = $ProfileSizes | Sort-Object -Property Length -Descending | ForEach-Object {
        $FormattedSizeUser = Format-FileSize -Length $_.Length
        "$($_.Name) $($FormattedSizeUser)"
    }

    Write-Host "All Profiles - $FormattedSize, $($AllProfiles -join ', ')"

    Ninja-Property-Set -Name $CustomField -Value "$AllProfiles"

    if ($Max -and $Max -gt 0) {
        if ($Largest.Length -gt $Max * 1GB) {
            Write-Host "Found profile over the max size of $Max GB."
            Write-Host "$($Largest.Name) profile is $($Largest.Length / 1GB) GB"
            exit 1
        }
    }
    exit 0
}
end {}

 

Analisi dettagliata

Lo script per trovare le dimensioni dei profili utente è suddiviso nelle seguenti sezioni: 

• Funzione dei cmdlet e parametri: Lo script per individuare e memorizzare le dimensioni dei profili utente inizia definendo i parametri, come ad esempio Max che imposta una soglia massima opzionale per le dimensioni dei profili utente e CustomField che specifica il nome del campo personalizzato da aggiornare. 
• Fase iniziale: Qui abbiamo due funzioni di utilità: 
  • Test-IsElevated: Controlla se lo script per individuare le dimensioni dei profili utente viene eseguito con privilegi di amministratore. 
  • Format-FileSize: Converte i byte in un formato leggibile che indica le dimensioni del file. 
• Fase di esecuzione: 
  • Lo script per trovare le dimensioni dei profili utente verifica la presenza di privilegi di amministratore. 
  • Quindi recupera tutti i profili degli utenti da “C:Users” e ne calcola le dimensioni. 
  • I profili vengono ordinati e vengono calcolate le dimensioni totali. 
  • I dati vengono inviati all’host e la funzione ‘Ninja-Property-Set’ aggiorna il campo personalizzato. 
  • Se viene specificato un parametro Max, lo script controlla i profili che superano queste dimensioni e genera un codice di uscita appropriato.

Situazioni d’uso potenziali

Immagina un MSP che supervisiona lo storage per un cliente aziendale. L’azienda si trova improvvisamente ad affrontare problemi relativi allo spazio di archiviazione. Invece di optare per costosi aggiornamenti dello storage, l’MSP utilizza questo script per identificare qualsiasi profilo utente sovradimensionato. Con i dati relativi alle dimensioni dei profili utente a disposizione, può quindi mettersi in contatto con utenti o reparti specifici per gestire e ottimizzare l’archiviazione.

Confronto

Tradizionalmente, per ottenere il totale delle dimensioni dei profili utente di Windows era necessario navigare manualmente tra le proprietà, le applicazioni di terze parti o script macchinosi. Questo script di PowerShell offre un approccio semplificato, utilizzando le funzionalità native di Windows per fornire informazioni precise e utilizzabili.

Domande frequenti

• Il privilegio di amministratore è obbligatorio?
  Sì, lo script richiede i privilegi di amministratore per essere eseguito. 
• Cosa succede se un profilo utente supera la dimensione massima specificata?
  Lo script genererà un messaggio che indica quale profilo supera la dimensione e restituirà il codice di uscita 1. 
• Qual è il nome predefinito del campo personalizzato se non ne viene specificato uno?
  È “TotalUsersProfileSize”. 

Implicazioni

Sebbene questo script per trovare le dimensioni dei profili utente sia immensamente vantaggioso, se non viene utilizzato correttamente potrebbe causare dei problemi di privacy. L’estrazione e la potenziale condivisione delle dimensioni dei profili utente potrebbero essere considerate pratiche invasive da alcuni utenti. D’altra parte, per la sicurezza IT, la comprensione dei modelli di archiviazione degli utenti può essere un modo proattivo per rilevare picchi insoliti di quantità di dati, che potrebbero indicare la presenza di malware o una potenziale violazione dei dati.

Suggerimenti

• Esegui sempre gli script di diagnostica, incluso quello per trovare le dimensioni dei profili utente, nelle ore non di punta per evitare possibili rallentamenti del sistema. 
• Assicurati di aver ottenuto le necessarie autorizzazioni e di aver informato le parti interessate prima di procedere con l’esecuzione dello script per trovare e memorizzare le dimensioni dei profili utente. 
• Aggiorna e controlla regolarmente lo script per allinearlo ai cambiamenti delle strutture e dei requisiti del sistema.

Considerazioni finali

Una piattaforma di gestione IT come NinjaOne può aumentare in modo significativo l’utilità di questo script, fornendo ai professionisti IT una visione più completa della salute, delle prestazioni e delle anomalie del sistema e dei collegamenti tra i vari aspetti. L’integrazione di tali script all’interno di NinjaOne può offrire informazioni in tempo reale, rendendo la gestione dello storage un’attività semplice.