{"id":809299,"date":"2026-05-18T07:38:24","date_gmt":"2026-05-18T07:38:24","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=809299"},"modified":"2026-05-18T07:38:24","modified_gmt":"2026-05-18T07:38:24","slug":"access-store-windows-user-profile-sizes-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/pt-br\/script-hub\/access-store-windows-user-profile-sizes-powershell\/","title":{"rendered":"Como acessar e armazenar tamanhos de perfis de usu\u00e1rio do Windows com o PowerShell"},"content":{"rendered":"

\u00c9 ineg\u00e1vel que o PowerShell revolucionou a maneira como os profissionais de TI gerenciam os sistemas Windows, automatizam tarefas rotineiras<\/a> e se aprofundam nos diagn\u00f3sticos do sistema. Hoje, vamos nos aprofundar em um script do PowerShell desenvolvido para avaliar o tamanho dos perfis de usu\u00e1rio no Windows<\/strong>, uma ferramenta crucial para administradores de sistemas e provedores de servi\u00e7os gerenciados (MSPs)<\/a>.<\/p>\n

Hist\u00f3rico<\/h2>\n

Com o aumento do big data e dos aplicativos cada vez mais sofisticados, o gerenciamento do armazenamento e a garantia da utiliza\u00e7\u00e3o eficiente do disco se tornaram fundamentais. Os profissionais de TI e os MSPs frequentemente enfrentam desafios decorrentes do ac\u00famulo de grandes quantidades de dados pelos usu\u00e1rios, \u00e0s vezes sem saber. Esse script aborda essa preocupa\u00e7\u00e3o, permitindo que os profissionais de TI determinem rapidamente os tamanhos dos perfis de usu\u00e1rio, garantindo o gerenciamento ideal do armazenamento e a integridade do sistema.<\/p>\n

O roteiro<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Updates a Custom Field with the total size of all User Profiles.\r\n    If the Max parameter is specified then it will return an exit code of 1\r\n     for any profile being over that Max threshold in GB.\r\n.DESCRIPTION\r\n    Updates a Custom Field with the total size of all User Profiles.\r\n    If the Max parameter is specified then it will return an exit code of 1\r\n     for any profile being over that Max threshold in GB.\r\n.EXAMPLE\r\n     -Max 60\r\n    Returns and exit code of 1 if any profile is over 60GB\r\n.EXAMPLE\r\n     -CustomField \"Something\"\r\n    Specifies the name of the custom field to update.\r\n.EXAMPLE\r\n    No Parameter needed.\r\n    Uses the default custom field name: TotalUsersProfileSize\r\n.OUTPUTS\r\n    None\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    Initial Release\r\nBy 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.\r\n    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. \r\n    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. \r\n    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. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, 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. \r\n    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. \r\n    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. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    [Alias(\"MaxSize\", \"Size\", \"ms\", \"m\", \"s\")]\r\n    [Double]\r\n    $Max,\r\n    [Parameter()]\r\n    [Alias(\"Custom\", \"Field\", \"cf\", \"c\", \"f\")]\r\n    [String]\r\n    $CustomField = \"TotalUsersProfileSize\"\r\n)\r\n\r\nbegin {\r\n    function Test-IsElevated {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)\r\n    }\r\n    function Format-FileSize {\r\n        param($Length)\r\n        switch ($Length) {\r\n            { $_ \/ 1TB -gt 1 } { \"$([Math]::Round(($_ \/ 1TB),2)) TB\"; break }\r\n            { $_ \/ 1GB -gt 1 } { \"$([Math]::Round(($_ \/ 1GB),2)) GB\"; break }\r\n            { $_ \/ 1MB -gt 1 } { \"$([Math]::Round(($_ \/ 1MB),2)) MB\"; break }\r\n            { $_ \/ 1KB -gt 1 } { \"$([Math]::Round(($_ \/ 1KB),2)) KB\"; break }\r\n            Default { \"$_ Bytes\" }\r\n        }\r\n    }\r\n}\r\nprocess {\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Error -Message \"Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    $Profiles = Get-ChildItem -Path \"C:Users\"\r\n    $ProfileSizes = $Profiles | ForEach-Object {\r\n        [PSCustomObject]@{\r\n            Name   = $_.BaseName\r\n            Length = Get-ChildItem -Path $_.FullName -Recurse -Force -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue | Select-Object -Property Sum -ExpandProperty Sum\r\n        }\r\n    }\r\n    $Largest = $ProfileSizes | Sort-Object -Property Length -Descending | Select-Object -First 1\r\n\r\n    $Size = $ProfileSizes | Measure-Object -Property Length -Sum -ErrorAction SilentlyContinue | Select-Object -Property Sum -ExpandProperty Sum\r\n\r\n    $FormattedSize = Format-FileSize -Length $Size\r\n\r\n    $AllProfiles = $ProfileSizes | Sort-Object -Property Length -Descending | ForEach-Object {\r\n        $FormattedSizeUser = Format-FileSize -Length $_.Length\r\n        \"$($_.Name) $($FormattedSizeUser)\"\r\n    }\r\n\r\n    Write-Host \"All Profiles - $FormattedSize, $($AllProfiles -join ', ')\"\r\n\r\n    Ninja-Property-Set -Name $CustomField -Value \"$AllProfiles\"\r\n\r\n    if ($Max -and $Max -gt 0) {\r\n        if ($Largest.Length -gt $Max * 1GB) {\r\n            Write-Host \"Found profile over the max size of $Max GB.\"\r\n            Write-Host \"$($Largest.Name) profile is $($Largest.Length \/ 1GB) GB\"\r\n            exit 1\r\n        }\r\n    }\r\n    exit 0\r\n}\r\nend {}<\/pre>\n
 <\/p>\n\n
Acesse mais de 300 scripts no NinjaOne Dojo<\/p>\n
Obter acesso<\/a><\/p>\n<\/div>\n
Detalhamento<\/h2>\n
O script em quest\u00e3o \u00e9 segmentado nas seguintes se\u00e7\u00f5es:<\/p>\n