{"id":534674,"date":"2025-09-30T17:01:40","date_gmt":"2025-09-30T17:01:40","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=534674"},"modified":"2025-09-30T17:01:40","modified_gmt":"2025-09-30T17:01:40","slug":"verifier-l-etat-du-bureau-a-distance-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/verifier-l-etat-du-bureau-a-distance-avec-powershell\/","title":{"rendered":"Comment utiliser PowerShell pour v\u00e9rifier l’\u00e9tat du bureau \u00e0 distance et la configuration des ports"},"content":{"rendered":"

Le protocole Remote Desktop Protocol (RDP)<\/a> est une fonctionnalit\u00e9 essentielle pour la gestion des syst\u00e8mes \u00e0 distance, que vous travailliez dans l’assistance informatique, l’administration des syst\u00e8mes ou que vous g\u00e9riez une entreprise MSP<\/a>. S’assurer que le RDP est correctement configur\u00e9 et surveiller le port sur lequel il \u00e9coute sont des t\u00e2ches vitales pour maintenir des terminaux s\u00e9curis\u00e9s et fonctionnels. Ce billet examine un script PowerShell qui v\u00e9rifie l’\u00e9tat et le port de Remote Desktop et enregistre \u00e9ventuellement le r\u00e9sultat dans un champ personnalis\u00e9 de NinjaOne. Il s’agit d’une solution pratique pour l’automatisation des rapports et des audits dans les environnements informatiques modernes.<\/p>\n

Contexte<\/h2>\n

Le bureau \u00e0 distance est activ\u00e9 par d\u00e9faut dans de nombreuses entreprises, mais sa configuration peut d\u00e9river au fil du temps. Des facteurs tels que les changements de strat\u00e9gie de groupe, les mises \u00e0 jour de s\u00e9curit\u00e9 ou les modifications apport\u00e9es par les utilisateurs peuvent d\u00e9sactiver RDP ou modifier son port d’\u00e9coute, ce qui rend les syst\u00e8mes inaccessibles ou vuln\u00e9rables. Dans les environnements plus vastes, en particulier ceux qui sont g\u00e9r\u00e9s par des plateformes RMM telles que NinjaOne<\/a>, il est impossible de v\u00e9rifier chaque machine manuellement. L’automatisation de ce contr\u00f4le au moyen d’un script PowerShell permet non seulement de gagner du temps, mais aussi de garantir l’exactitude et la conformit\u00e9.<\/p>\n

Ce script a \u00e9t\u00e9 con\u00e7u en tenant compte de l’int\u00e9gration de NinjaOne, ce qui le rend particuli\u00e8rement utile pour les MSP et les services informatiques qui utilisent cette plateforme. Il ne se contente pas de recueillir l’\u00e9tat RDP, il prend \u00e9galement en charge l’enregistrement automatique dans un champ personnalis\u00e9, ce qui facilite la documentation des actifs.<\/p>\n

Le script<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Reports the status of Remote Desktop and the port it is listening on.\r\n.DESCRIPTION\r\n    Reports the status of Remote Desktop and the port it is listening on.\r\n    With the option to save the results to a custom field.\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.EXAMPLE\r\n    (No Parameters)\r\n    ## EXAMPLE OUTPUT WITHOUT PARAMS ##\r\n    [Info] Enabled | Port: 3389\r\n\r\nPARAMETER: -RdpStatusCustomFieldName \"RDPStatus\"\r\n    Name of a custom field to save the results to.\r\n.EXAMPLE\r\n    -RdpStatusCustomFieldName \"RDPStatus\"\r\n    ## EXAMPLE OUTPUT WITH RdpStatusCustomFieldName ##\r\n    [Info] Enabled | Port: 3389\r\n    [Info] Attempting to set Custom Field 'RDPStatus'.\r\n    [Info] Successfully set Custom Field 'RDPStatus'!\r\n    \r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes: Initial Release\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    [String]$RdpStatusCustomFieldName\r\n)\r\n\r\nbegin {\r\n    function Set-NinjaProperty {\r\n        [CmdletBinding()]\r\n        Param(\r\n            [Parameter(Mandatory = $True)]\r\n            [String]$Name,\r\n            [Parameter()]\r\n            [String]$Type,\r\n            [Parameter(Mandatory = $True, ValueFromPipeline = $True)]\r\n            $Value,\r\n            [Parameter()]\r\n            [String]$DocumentName\r\n        )\r\n        \r\n        # Measure the number of characters in the provided value\r\n        $Characters = $Value | ConvertTo-Json | Measure-Object -Character | Select-Object -ExpandProperty Characters\r\n    \r\n        # Throw an error if the value exceeds the character limit of 200,000 characters\r\n        if ($Characters -ge 200000) {\r\n            throw [System.ArgumentOutOfRangeException]::New(\"Character limit exceeded: the value is greater than or equal to 200,000 characters.\")\r\n        }\r\n        \r\n        # Initialize a hashtable for additional documentation parameters\r\n        $DocumentationParams = @{}\r\n    \r\n        # If a document name is provided, add it to the documentation parameters\r\n        if ($DocumentName) { $DocumentationParams[\"DocumentName\"] = $DocumentName }\r\n        \r\n        # Define a list of valid field types\r\n        $ValidFields = \"Attachment\", \"Checkbox\", \"Date\", \"Date or Date Time\", \"Decimal\", \"Dropdown\", \"Email\", \"Integer\", \"IP Address\", \"MultiLine\", \"MultiSelect\", \"Phone\", \"Secure\", \"Text\", \"Time\", \"URL\", \"WYSIWYG\"\r\n    \r\n        # Warn the user if the provided type is not valid\r\n        if ($Type -and $ValidFields -notcontains $Type) { Write-Warning \"$Type is an invalid type. Please check here for valid types: https:\/\/ninjarmm.zendesk.com\/hc\/en-us\/articles\/16973443979789-Command-Line-Interface-CLI-Supported-Fields-and-Functionality\" }\r\n        \r\n        # Define types that require options to be retrieved\r\n        $NeedsOptions = \"Dropdown\"\r\n    \r\n        # If the property is being set in a document or field and the type needs options, retrieve them\r\n        if ($DocumentName) {\r\n            if ($NeedsOptions -contains $Type) {\r\n                $NinjaPropertyOptions = Ninja-Property-Docs-Options -AttributeName $Name @DocumentationParams 2>&1\r\n            }\r\n        }\r\n        else {\r\n            if ($NeedsOptions -contains $Type) {\r\n                $NinjaPropertyOptions = Ninja-Property-Options -Name $Name 2>&1\r\n            }\r\n        }\r\n        \r\n        # Throw an error if there was an issue retrieving the property options\r\n        if ($NinjaPropertyOptions.Exception) { throw $NinjaPropertyOptions }\r\n            \r\n        # Process the property value based on its type\r\n        switch ($Type) {\r\n            \"Checkbox\" {\r\n                # Convert the value to a boolean for Checkbox type\r\n                $NinjaValue = [System.Convert]::ToBoolean($Value)\r\n            }\r\n            \"Date or Date Time\" {\r\n                # Convert the value to a Unix timestamp for Date or Date Time type\r\n                $Date = (Get-Date $Value).ToUniversalTime()\r\n                $TimeSpan = New-TimeSpan (Get-Date \"1970-01-01 00:00:00\") $Date\r\n                $NinjaValue = $TimeSpan.TotalSeconds\r\n            }\r\n            \"Dropdown\" {\r\n                # Convert the dropdown value to its corresponding GUID\r\n                $Options = $NinjaPropertyOptions -replace '=', ',' | ConvertFrom-Csv -Header \"GUID\", \"Name\"\r\n                $Selection = $Options | Where-Object { $_.Name -eq $Value } | Select-Object -ExpandProperty GUID\r\n            \r\n                # Throw an error if the value is not present in the dropdown options\r\n                if (!($Selection)) {\r\n                    throw [System.ArgumentOutOfRangeException]::New(\"Value is not present in dropdown options.\")\r\n                }\r\n            \r\n                $NinjaValue = $Selection\r\n            }\r\n            default {\r\n                # For other types, use the value as is\r\n                $NinjaValue = $Value\r\n            }\r\n        }\r\n            \r\n        # Set the property value in the document if a document name is provided\r\n        if ($DocumentName) {\r\n            $CustomField = Ninja-Property-Docs-Set -AttributeName $Name -AttributeValue $NinjaValue @DocumentationParams 2>&1\r\n        }\r\n        else {\r\n            # Otherwise, set the standard property value\r\n            $CustomField = $NinjaValue | Ninja-Property-Set-Piped -Name $Name 2>&1\r\n        }\r\n            \r\n        # Throw an error if setting the property failed\r\n        if ($CustomField.Exception) {\r\n            throw $CustomField\r\n        }\r\n    }\r\n}\r\nprocess {\r\n\r\n    if ($env:rdpStatusCustomFieldName -and $env:rdpStatusCustomFieldName -notlike \"null\") { $RdpStatusCustomFieldName = $env:rdpStatusCustomFieldName }\r\n\r\n    # Terminal Server registry path\r\n    $RdpPath = 'HKLM:\\SYSTEM\\CurrentControlSet\\Control\\Terminal Server'\r\n    # Deny RDP Connections\r\n    $DenyRdpConnections = Get-ItemProperty -Path $RdpPath -Name 'fDenyTSConnections' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty fDenyTSConnections -ErrorAction SilentlyContinue\r\n    # RDP Port\r\n    $RdpPort = Get-ItemProperty -Path \"$RdpPath\\WinStations\\RDP-Tcp\" -Name PortNumber -ErrorAction SilentlyContinue | Select-Object -ExpandProperty PortNumber -ErrorAction SilentlyContinue\r\n\r\n    # 1 or $null = Disabled (Default)\r\n    # 0 = Enabled\r\n    $RdpEnabled = if ($DenyRdpConnections -eq 0) { \"Enabled\" }else { \"Disabled\" }\r\n    # 3389 or $null = 3389 (Default)\r\n    $RdpPort = if ($null -eq $RdpPort) { \"3389\" }else { \"$RdpPort\" }\r\n\r\n    $Report = \"$RdpEnabled | Port: $RdpPort\"\r\n\r\n    Write-Host \"[Info] $Report\"\r\n\r\n    if ($RdpStatusCustomFieldName) {\r\n        try {\r\n            Write-Host \"[Info] Attempting to set Custom Field '$RdpStatusCustomFieldName'.\"\r\n            Set-NinjaProperty -Name $RdpStatusCustomFieldName -Value $Report\r\n            Write-Host \"[Info] Successfully set Custom Field '$RdpStatusCustomFieldName'!\"\r\n        }\r\n        catch {\r\n            Write-Host \"[Error] $($_.Exception.Message)\"\r\n            exit 1\r\n        }\r\n    }\r\n\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
Description d\u00e9taill\u00e9e<\/h2>\n
\u00c0 un niveau \u00e9lev\u00e9, le script effectue trois t\u00e2ches :<\/p>\n
    \n
  1. V\u00e9rifie si RDP est activ\u00e9<\/strong><\/li>\n
  2. D\u00e9termine le port utilis\u00e9 par RDP<\/strong><\/li>\n
  3. Optionnellement, les r\u00e9sultats sont enregistr\u00e9s dans un champ personnalis\u00e9 NinjaOne<\/strong><\/li>\n<\/ol>\n
    Flux \u00e9tape par \u00e9tape<\/h3>\n
      \n
    1. Traitement des param\u00e8tres<\/strong><\/li>\n<\/ol>\n
      Le script accepte un param\u00e8tre facultatif :<\/p>\n
      powershell<\/p>\n
      CopyEdit<\/p>\n
      [String]$RdpStatusCustomFieldName<\/strong><\/p>\n
      Cette option permet \u00e0 l’utilisateur de sp\u00e9cifier un champ personnalis\u00e9 NinjaOne dans lequel les r\u00e9sultats seront enregistr\u00e9s.<\/p>\n
        \n
      1. Support des variables d’environnement<\/strong><\/li>\n<\/ol>\n
        Si le param\u00e8tre n’est pas transmis, le script v\u00e9rifie la variable d’environnement $env:rdpStatusCustomFieldName<\/strong>, afin d’assurer la compatibilit\u00e9 avec les variables d’ex\u00e9cution inject\u00e9es.<\/p>\n
          \n
        1. Consultation du registre<\/strong><\/li>\n<\/ol>\n
          Deux cl\u00e9s de registre critiques sont interrog\u00e9es :<\/p>\n