{"id":534650,"date":"2025-09-30T16:47:50","date_gmt":"2025-09-30T16:47:50","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=534650"},"modified":"2025-09-30T16:47:50","modified_gmt":"2025-09-30T16:47:50","slug":"mettre-a-jour-la-description-des-appareils-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/mettre-a-jour-la-description-des-appareils-avec-powershell\/","title":{"rendered":"Comment mettre \u00e0 jour la description des appareils avec PowerShell"},"content":{"rendered":"

La gestion et le maintien d’une convention de d\u00e9nomination constante pour les actifs informatiques sont essentiels pour optimiser les op\u00e9rations, garantir l’exactitude de l’inventaire et assurer la conformit\u00e9. Parmi les diff\u00e9rents attributs de m\u00e9tadonn\u00e9es assign\u00e9s \u00e0 un syst\u00e8me Windows, la description des appareils est souvent n\u00e9glig\u00e9e.<\/p>\n

Cependant, ce petit \u00e9l\u00e9ment d’information peut consid\u00e9rablement am\u00e9liorer la clart\u00e9 dans les environnements informatiques, en particulier lorsqu’il est int\u00e9gr\u00e9 \u00e0 des plateformes de suivi des actifs et de gestion \u00e0 distance. Dans cet article, nous verrons comment<\/strong> mettre \u00e0 jour la description des appareils avec PowerShell<\/strong>, un petit changement qui peut am\u00e9liorer l’efficacit\u00e9<\/a> administrative.<\/p>\n

Contexte<\/h2>\n

Dans de nombreux environnements, en particulier ceux qui sont g\u00e9r\u00e9s par des fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> ou des \u00e9quipes informatiques internes, les m\u00e9tadonn\u00e9es des appareils jouent un r\u00f4le crucial dans l’identification et l’organisation des appareils. Le champ \u00ab\u00a0description de l’appareil\u00a0\u00bb est utilis\u00e9 pour fournir des informations contextuelles sur l’appareil, telles que sa fonction ou l’utilisateur auquel il a \u00e9t\u00e9 attribu\u00e9. Malheureusement, la mise \u00e0 jour manuelle de cette description par le biais d’interfaces graphiques est inefficace, en particulier \u00e0 grande \u00e9chelle.<\/p>\n

Ce script PowerShell<\/a> comble cette lacune en permettant aux professionnels de l’informatique d’automatiser le processus de mise \u00e0 jour ou d’effacement des descriptions des appareils. En prenant en charge les entr\u00e9es de variables d’environnement et en validant leur utilisation correcte, il garantit une ex\u00e9cution fiable, qu’elle soit d\u00e9ploy\u00e9e de mani\u00e8re interactive ou par le biais de plateformes de gestion \u00e0 distance telles que NinjaOne.<\/p>\n

Le script<\/h2>\n
#Requires -Version 4\r\n\r\n<#\r\n.SYNOPSIS\r\n    Updates the current device description.\r\n.DESCRIPTION\r\n    Updates the current device description.\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.EXAMPLE\r\n    -Description \"Kitchen Computer\"\r\n    \r\n    Attempting to set device description to 'Kitchen Computer'.\r\n\r\n\r\n    SystemDirectory : C:\\Windows\\system32\r\n    Organization    : vm.net\r\n    BuildNumber     : 9600\r\n    RegisteredUser  : NA\r\n    SerialNumber    : 00252-70000-00000-AA382\r\n    Version         : 6.3.9600\r\n\r\n    Successfully set device description to 'Kitchen Computer'.\r\n\r\n\r\nPARAMETER: -Description \"ReplaceMeWithADeviceDescription\"\r\n    Specify the device description you would like to set.\r\n\r\nPARAMETER: -ClearDescription\r\n    Clear the current device description.\r\n\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2012 R2\r\n    Release Notes: Initial Release\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    [String]$Description,\r\n    [Parameter()]\r\n    [Switch]$ClearDescription = [System.Convert]::ToBoolean($env:clearDeviceDescription)\r\n)\r\n\r\nbegin {\r\n    if($env:deviceDescription -and $env:deviceDescription -notlike \"null\"){ $Description = $env:deviceDescription }\r\n\r\n    # Trim any leading or trailing whitespace from the description, if it exists\r\n    if ($Description) {\r\n        $Description = $Description.Trim()\r\n    }\r\n\r\n    # Ensure that a description is provided if clearing the description is not requested\r\n    if (!$Description -and !$ClearDescription) {\r\n        Write-Host -Object \"[Error] You must provide a description to set.\"\r\n        exit 1\r\n    }\r\n\r\n    # Ensure that both clearing and setting the description are not requested simultaneously\r\n    if ($ClearDescription -and $Description) {\r\n        Write-Host -Object \"[Error] You cannot clear and set the device description at the same time.\"\r\n        exit 1\r\n    }\r\n\r\n    # Clear the description if requested\r\n    if ($ClearDescription) {\r\n        $Description = $Null\r\n    }\r\n\r\n    # Measure the length of the description\r\n    $DescriptionLength = $Description | Measure-Object -Character | Select-Object -ExpandProperty Characters\r\n    # Warn if the description is longer than 40 characters\r\n    if ($DescriptionLength -ge 40) {\r\n        Write-Host -Object \"[Warning] The description '$Description' is greater than 40 characters. It may appear trimmed in certain situations.\"\r\n    }\r\n\r\n    # Function to check if the script is running with elevated (administrator) privileges\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\r\n    if (!$ExitCode) {\r\n        $ExitCode = 0\r\n    }\r\n}\r\nprocess {\r\n    # Check if the script is running with elevated (administrator) privileges\r\n    if (!(Test-IsElevated)) {\r\n        Write-Host -Object \"[Error] Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    try {\r\n        Write-Host -Object \"Attempting to set device description to '$Description'.\"\r\n        # Determine the PowerShell version and set the operating system description accordingly\r\n        if ($PSVersionTable.PSVersion.Major -lt 5) {\r\n            # Use Get-WmiObject for PowerShell versions less than 5\r\n            Get-WmiObject -Class Win32_OperatingSystem -ErrorAction Stop | Set-WmiInstance -Property @{ 'Description' = $Description } -ErrorAction Stop\r\n        }\r\n        else {\r\n            # Use Get-CimInstance for PowerShell version 5 or greater\r\n            Get-CimInstance -Class Win32_OperatingSystem -ErrorAction Stop | Set-CimInstance -Property @{ 'Description' = $Description } -ErrorAction Stop\r\n        }\r\n        Write-Host -Object \"Successfully set device description to '$Description'.\"\r\n    }\r\n    catch {\r\n        # Handle any errors that occur while retrieving the device description\r\n        Write-Host -Object \"[Error] Failed to set the device description.\"\r\n        Write-Host -Object \"[Error] $($_.Exception.Message)\"\r\n        exit 1\r\n    }\r\n\r\n    exit $ExitCode\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
Description d\u00e9taill\u00e9e<\/h2>\n
Examinons le script ligne par ligne pour comprendre son fonctionnement et l’importance de chaque section.<\/p>\n
Traitement des param\u00e8tres<\/h3>\n
powershell<\/p>\n
CopyEdit<\/p>\n
param (<\/p>\n
[String]$Description,<\/p>\n
[Switch]$ClearDescription = [System.Convert]::ToBoolean($env:clearDeviceDescription)<\/p>\n
)<\/p>\n
Le script accepte deux param\u00e8tres\u00a0:<\/p>\n