Cómo conocer el tamaño de los perfiles de usuario de Windows y almacenarlos con PowerShell

Es innegable que PowerShell ha revolucionado la forma en que los profesionales de TI gestionan los sistemas Windows, automatizan tareas mundanas y profundizan en el diagnóstico de sistemas. Hoy nos adentramos en un script de PowerShell diseñado para evaluar el tamaño de los perfiles de usuario en Windows, una herramienta crucial para los administradores de sistemas y los proveedores de servicios gestionados (MSP).

Antecedentes

Con el auge de los macrodatos y las aplicaciones cada vez más sofisticadas, gestionar el almacenamiento y garantizar una utilización eficiente de los discos se ha convertido en algo primordial. Los profesionales de TI y los MSP se enfrentan a menudo a retos derivados de la acumulación de grandes cantidades de datos por parte de los usuarios, a veces sin saberlo. Este script aborda este problema permitiendo a los profesionales de TI determinar rápidamente el tamaño de los perfiles de usuario, garantizando una gestión óptima del almacenamiento y la salud del sistema.

El script para conocer el tamaño de los perfiles de usuario de Windows y almacenarlos

#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 {}

 

Descripción detallada

El script para conocer el tamaño de los perfiles de usuario está segmentado en las siguientes secciones:

• Funciones y parámetros del cmdlet: el script comienza definiendo parámetros, como Max, que establece un umbral opcional para el tamaño del perfil, y CustomField, que especifica el nombre del campo personalizado que se va a actualizar.
• Fase inicial: aquí tenemos dos funciones útiles:
  • Test-IsElevated: comprueba si el script para conocer el tamaño de los perfiles de usuario se ejecuta con privilegios de administrador.
  • Format-FileSize: convierte los bytes a un formato legible de tamaño de archivo.
• Fase de ejecución:
  • El script para conocer el tamaño de los perfiles de usuario comprueba si se dispone de privilegios de administrador.
  • A continuación, recupera todos los perfiles de usuario de «C:Users» y calcula su tamaño.
  • Los perfiles se clasifican y se calcula el tamaño total.
  • Los datos se envían al host, y la función ‘Ninja-Property-Set’ actualiza el campo personalizado.
  • Si se especifica un parámetro Max, el script comprueba si los perfiles superan este tamaño y sale con un código apropiado.

Posibles casos de uso

Pensemos en un MSP que supervisa el almacenamiento de un cliente corporativo. De repente, la empresa se enfrenta a problemas de almacenamiento. En lugar de optar por costosas actualizaciones de almacenamiento, el MSP utiliza este script para identificar cualquier perfil de usuario sobredimensionado. Armados con estos datos relativos al tamaño de los perfiles de usuario, pueden ponerse en contacto con usuarios o departamentos específicos para gestionar y racionalizar mejor el almacenamiento.

Comparación

Tradicionalmente, para obtener el total del tamaño de los perfiles de usuario de Windows era necesario navegar manualmente por las propiedades, aplicaciones de terceros o engorrosos scripts. Este script de PowerShell para conocer el tamaño de los perfiles de usuario ofrece un enfoque óptimo, utilizando las funciones nativas de Windows para obtener información precisa y práctica.

Preguntas frecuentes

• ¿Es obligatorio el privilegio de administrador?
  Sí, el script requiere privilegios de administrador para ejecutarse.
• ¿Qué ocurre si un perfil de usuario supera el tamaño máximo especificado?
  El script mostrará un mensaje indicando qué perfil excede el tamaño y devolverá un código de salida de 1.
• ¿Cuál es el nombre por defecto del campo personalizado si no se especifica?
  Es «TotalUsersProfileSize».

Implicaciones

Aunque este script es extremadamente útil, si no se utiliza de forma correcta, podría plantear problemas de privacidad. Extraer y potencialmente compartir tamaños de perfiles de usuario podría ser visto como invasivo por algunos usuarios. Además, para la seguridad informática, conocer los patrones de almacenamiento de los usuarios puede ser una forma proactiva de detectar picos inusuales de datos, que podrían indicar la existencia de malware o de una posible filtración de datos.

Recomendaciones

• Ejecuta los scripts de diagnósticos siempre fuera de las horas punta para evitar posibles retrasos del sistema.
• Asegúrate de haber obtenido los permisos necesarios y de haber informado a las partes interesadas antes de la ejecución.
• Actualiza y mantén periódicamente el script para adaptarlo a los cambios en las estructuras y requisitos del sistema.

Reflexiones finales

Una plataforma de gestión de TI como NinjaOne puede aumentar significativamente la utilidad de este script para conocer el tamaño de los perfiles de usuario, proporcionando a los profesionales de TI una visión más global de la salud del sistema, el rendimiento y las anomalías. La integración de estos scripts en NinjaOne puede ofrecer información en tiempo real, haciendo que la gestión del almacenamiento sea más fácil.