Comment savoir la taille des profils utilisateur Windows et les stocker avec PowerShell

PowerShell a indéniablement révolutionné la manière dont les professionnels de l’informatique gèrent les systèmes Windows, automatisent les tâches banales et approfondissent les diagnostics système. Aujourd’hui, nous nous penchons sur un script PowerShell conçu pour évaluer la taille des profils utilisateur sous Windows, un outil essentiel pour les administrateurs système et les fournisseurs de services gérés (MSP).

Contexte

Avec l’essor du big data et des applications de plus en plus sophistiquées, la gestion du stockage et l’utilisation efficace des disques sont devenues primordiales. Les professionnels de l’informatique et les MSP sont souvent confrontés à des problèmes liés à l’accumulation de grandes quantités de données par les utilisateurs, parfois à leur insu. Ce script répond à cette préoccupation en permettant aux professionnels de l’informatique de déterminer rapidement la taille des profils utilisateur, garantissant ainsi une gestion optimale du stockage et de la performance du système.

Le script

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

 

Description détaillée

Le script en question est divisé en plusieurs sections :

• Liaison et paramètres de la cmdlet: Le script commence par définir des paramètres, tels que Max, qui définit un seuil facultatif pour la taille du profil, et CustomField, qui spécifie le nom du champ personnalisé à mettre à jour.
• Section de début: Ici, nous avons deux fonctions utiles :
  • Test-IsElevated: Vérifie si le script est exécuté avec des droits d’administrateur.
  • Format-FileSize: Convertit les octets en un format lisible de taille de fichier.
• Section de processus:
  • Le script vérifie la présence de droits d’administrateur.
  • Il récupère ensuite tous les profils utilisateur dans « C:Users » et calcule leur taille.
  • Les profils sont triés et la taille totale est calculée.
  • Les données sont envoyées à l’hôte et la fonction « Ninja-Property-Set » met à jour le champ personnalisé.
  • Si un paramètre Max est spécifié, le script vérifie si les profils dépassent cette taille et sort avec un code approprié.

Cas d’utilisation potentiels

Prenons l’exemple d’une entreprise MSP qui supervise le stockage pour une entreprise cliente. L’entreprise est soudainement confrontée à des contraintes de stockage. Au lieu d’opter pour des mises à niveau coûteuses du stockage, le MSP utilise ce script pour identifier les profils utilisateur surdimensionnés. Armés de ces données, ils peuvent alors se mettre en relation avec des utilisateurs ou des services spécifiques pour mieux gérer et rationaliser le stockage.

Comparaison

Traditionnellement, l’obtention des tailles des profils utilisateur de Window nécessitait une navigation manuelle dans les propriétés, des applications tierces ou des scripts encombrants. Ce script PowerShell offre une approche optimale, utilisant les fonctionnalités natives de Windows pour fournir des informations précises et exploitables.

FAQ

• Le statut d’administrateur est-il obligatoire ?
  Oui, le script nécessite des droits d’administrateur pour être exécuté.
• Que se passe-t-il si un profil utilisateur dépasse la taille maximale spécifiée ?
  Le script affiche un message indiquant quel profil dépasse la taille et renvoie un code de sortie égal à 1.
• Quel est le nom du champ personnalisé par défaut s’il n’est pas spécifié ?
  Il s’agit de « TotalUsersProfileSize ».

Implications

Bien que ce script soit extrêmement utile, il peut poser des problèmes de protection de la vie privée s’il n’est pas utilisé correctement. L’extraction et le partage éventuel des tailles des profils utilisateur peuvent être considérés comme invasifs par certains utilisateurs. De plus, pour la sécurité informatique, la compréhension des modèles de stockage des utilisateurs peut être un moyen proactif de détecter des pics de données inhabituels, qui pourraient indiquer la présence de logiciels malveillants ou une violation potentielle des données.

Recommandations

• Exécutez toujours les scripts de diagnostic pendant les heures creuses afin d’éviter d’éventuels retards du système.
• Assurez-vous d’avoir obtenu les autorisations nécessaires et d’avoir informé les parties prenantes avant de procéder à l’exécution.
• Mettez à jour régulièrement le script pour répondre à l’évolution des structures et des exigences du système.

Conclusions

Une plateforme de gestion informatique telle que NinjaOne peut considérablement accroître l’utilité de ce script, en fournissant aux professionnels de l’informatique une vue plus complète de l’état, des performances et des anomalies du système. L’intégration de tels scripts dans NinjaOne permet d’obtenir des informations en temps réel, rendant ainsi la gestion du stockage plus facile.