{"id":353650,"date":"2024-08-27T09:23:12","date_gmt":"2024-08-27T09:23:12","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/verifier-l-existence-d-un-fichier-powershell\/"},"modified":"2024-10-13T19:07:58","modified_gmt":"2024-10-13T19:07:58","slug":"verifier-l-existence-d-un-fichier-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/verifier-l-existence-d-un-fichier-powershell\/","title":{"rendered":"Comment utiliser un script PowerShell pour v\u00e9rifier l&rsquo;existence d&rsquo;un fichier ou d&rsquo;un dossier dans Windows ?"},"content":{"rendered":"<p>Dans le paysage informatique moderne, la gestion et la maintenance des syst\u00e8mes de fichiers sur de nombreux serveurs et postes de travail peuvent s&rsquo;av\u00e9rer difficiles. Les professionnels de l&rsquo;informatique, en particulier ceux qui travaillent pour des <a href=\"https:\/\/www.ninjaone.com\/fr\/quest-ce-quun-msp\" target=\"_blank\" rel=\"noopener\">fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a>, ont souvent besoin de <strong>contr\u00f4ler des fichiers et des r\u00e9pertoires sp\u00e9cifiques<\/strong> pour garantir la conformit\u00e9, la s\u00e9curit\u00e9 et l&rsquo;efficacit\u00e9 op\u00e9rationnelle.<\/p>\n<p>Un moyen efficace d&rsquo;accomplir cette t\u00e2che est d&rsquo;utiliser les scripts <a href=\"https:\/\/www.ninjaone.com\/it-hub\/endpoint-management\/what-is-powershell\/\" target=\"_blank\" rel=\"noopener\">PowerShell<\/a>, qui permettent d&rsquo;automatiser et de contr\u00f4ler en d\u00e9tail les environnements Windows. Le script PowerShell fourni est con\u00e7u pour alerter les utilisateurs si un fichier ou un dossier sp\u00e9cifi\u00e9 est trouv\u00e9 dans un r\u00e9pertoire ou un sous-r\u00e9pertoire donn\u00e9, ce qui en fait un outil pr\u00e9cieux pour les professionnels de l&rsquo;informatique.<\/p>\n<h2>Contexte<\/h2>\n<p>Le contr\u00f4le de l&rsquo;existence et de l&#8217;emplacement des fichiers est crucial pour plusieurs raisons. Il contribue au maintien de la s\u00e9curit\u00e9 en s&rsquo;assurant qu&rsquo;aucun fichier non autoris\u00e9 n&rsquo;est pr\u00e9sent, favorise la conformit\u00e9 en v\u00e9rifiant que les fichiers n\u00e9cessaires sont en place et contribue \u00e0 l&rsquo;efficacit\u00e9 op\u00e9rationnelle en automatisant les contr\u00f4les de routine. Ce script est particuli\u00e8rement utile pour les professionnels de l&rsquo;informatique qui doivent g\u00e9rer de grands r\u00e9seaux ou des environnements clients multiples. L&rsquo;automatisation du processus de recherche et d&rsquo;alerte permet de gagner du temps et de r\u00e9duire le risque d&rsquo;erreur humaine.<\/p>\n<h2>Le script<\/h2>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"powershell\">#Requires -Version 5.1\r\n\r\n&lt;#\r\n.SYNOPSIS\r\n    Alert if a specified file or folder is found in a directory or subdirectory you specify.\r\n.DESCRIPTION\r\n    Alert if a specified file or folder is found in a directory or subdirectory you specify.\r\n\r\n.EXAMPLE\r\n    -SearchPath \"C:\" -FileOrFolder \"autounattend\"\r\n\r\n    WARNING: Backslash missing from the search path. Changing it to C:\\.\r\n    [Alert] File Found.\r\n    C:\\Users\\Administrator\\Desktop\\ExampleFolder\\Test Folder 1\\autounattend.xml\r\n    C:\\Users\\Administrator\\Desktop\\ExampleFolder\\Test Folder 2\\autounattend.xml\r\n    C:\\Users\\Administrator\\Desktop\\ExampleFolder\\TestFolder1\\Test Folder 1\\autounattend.xml\r\n    C:\\Users\\Administrator\\Desktop\\ExampleFolder\\TestFolder1\\Test Folder 2\\autounattend.xml\r\n    C:\\Users\\Administrator\\Desktop\\ExampleFolder\\TestFolder2\\Test Folder 1\\TestFolder1\\autounattend.xml\r\n    Attempting to set Custom Field 'multiline'.\r\n    Successfully set Custom Field 'multiline'!\r\n\r\nPARAMETER: -SeachPath \"C:\\ReplaceMeWithAvalidPath\"\r\n    Enter the starting directories for the search, separated by commas. This will include all subdirectories as well.\r\n\r\nPARAMETER: -FileOrFolder \"ReplaceMeWithNameToSearchFor\"\r\n    Specify the full or partial name of a file or folder to find. E.g., 'config' or '.exe'.\r\n\r\nPARAMETER: -SearchType \"Files and Folders\"\r\n    Limit the search to either files, folders, or both.\r\n\r\nPARAMETER: -Timeout \"30\"\r\n    Maximum search time in minutes, halts search if exceeded.\r\n\r\nPARAMETER: -CustomField \"ReplaceMeWithNameOfMultilineCustomField\"\r\n    Optional multiline field to record search results. Leave blank if unused.\r\n\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes: 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#&gt;\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    [String]$SearchPath = \"C:\\Windows,C:\\Program Files\",\r\n    [Parameter()]\r\n    [String]$FileOrFolder,\r\n    [Parameter()]\r\n    [String]$SearchType = \"Files and Folders\",\r\n    [Parameter()]\r\n    [Int]$Timeout = 30,\r\n    [Parameter()]\r\n    [String]$CustomField\r\n)\r\n\r\nbegin {\r\n    # Set parameters using dynamic script variables.\r\n    if ($env:searchPath -and $env:searchPath -notlike \"null\") { $SearchPath = $env:searchPath }\r\n    if ($env:fileNameOrFolderNameToSearchFor -and $env:fileNameOrFolderNameToSearchFor -notlike \"null\") { $FileOrFolder = $env:fileNameOrFolderNameToSearchFor }\r\n    if ($env:searchType -and $env:searchType -notlike \"null\") { $SearchType = $env:searchType }\r\n    if ($env:timeoutInMinutes -and $env:timeoutInMinutes -notlike \"null\") { $Timeout = $env:timeoutInMinutes }\r\n    if ($env:customFieldName -and $env:customFieldName -notlike \"null\") { $CustomField = $env:customFieldName }\r\n\r\n    # Error out if no search path was given.\r\n    if (-not $SearchPath) {\r\n        Write-Host \"[Error] No search path given!\"\r\n        exit 1\r\n    }\r\n\r\n    # If given a comma-separated list, split the paths.\r\n    $PathsToSearch = New-Object System.Collections.Generic.List[String]\r\n    if ($SearchPath -match \",\") {\r\n        $SearchPath -split \",\" | ForEach-Object { $PathsToSearch.Add($_.Trim()) }\r\n    }\r\n    else {\r\n        $PathsToSearch.Add($SearchPath)\r\n    }\r\n\r\n    # Initialize a generic list for paths to remove or replace.\r\n    $ReplacementPaths = New-Object System.Collections.Generic.List[Object]\r\n    $PathsToRemove = New-Object System.Collections.Generic.List[String]\r\n\r\n    # If given a drive without the backslash add it in.\r\n    $PathsToSearch | ForEach-Object {\r\n        if ($_ -notmatch '^[A-Z]:\\\\$' -and $_ -match '^[A-Z]:$') {\r\n            $NewPath = \"$_\\\"\r\n            $ReplacementPaths.Add(\r\n                [PSCustomObject]@{\r\n                    Index   = $PathsToSearch.IndexOf(\"$_\")\r\n                    NewPath = $NewPath\r\n                }\r\n            )\r\n                \r\n            Write-Warning \"Backslash missing from the search path. Changing it to $NewPath.\"\r\n        }\r\n    }\r\n\r\n    # Apply replacements.\r\n    $ReplacementPaths | ForEach-Object {\r\n        $PathsToSearch[$_.index] = $_.NewPath \r\n    }\r\n\r\n    # Check if the search path is valid.\r\n    $PathsToSearch | ForEach-Object {\r\n        if (-not (Test-Path $_)) {\r\n            Write-Host -Object \"[Error] $_ does not exist!\"\r\n            $PathsToRemove.Add($_)\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    # Remove Paths that do not exist.\r\n    $PathsToRemove | ForEach-Object {\r\n        $PathsToSearch.Remove($_) | Out-Null\r\n    }\r\n\r\n    # Error out if no valid paths to search.\r\n    if ($($PathsToSearch).Count -eq 0) {\r\n        Write-Host \"[Error] No valid paths to search!\"\r\n        exit 1\r\n    }\r\n\r\n    # If we're not given a file or folder error out.\r\n    if (-not $FileOrFolder) {\r\n        Write-Host -Object \"[Error] No file or folder given to search for!\"\r\n        exit 1\r\n    }\r\n\r\n    # Timeout must be within a given range in minutes.\r\n    if ($Timeout -lt 1 -or $Timeout -gt 120) {\r\n        Write-Host -Object \"[Error] Timeout is greater than 120 minutes or less than 1 minute.\"\r\n        exit 1\r\n    }\r\n\r\n    # Scope the search to either files only or folders only.\r\n    $ValidSearchTypes = \"Files and Folders\", \"Files Only\", \"Folders Only\"\r\n    if ($ValidSearchTypes -notcontains $SearchType) {\r\n        Write-Host -Object \"[Error] Invalid search type.\"\r\n        exit 1\r\n    }\r\n\r\n    # Test for local administrator rights.\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    # Handy function to set a custom field.\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        $Characters = $Value | Measure-Object -Character | Select-Object -ExpandProperty Characters\r\n        if ($Characters -ge 10000) {\r\n            throw [System.ArgumentOutOfRangeException]::New(\"Character limit exceeded, value is greater than 10,000 characters.\")\r\n        }\r\n        \r\n        # If we're requested to set the field value for a Ninja document we'll specify it here.\r\n        $DocumentationParams = @{}\r\n        if ($DocumentName) { $DocumentationParams[\"DocumentName\"] = $DocumentName }\r\n        \r\n        # This is a list of valid fields that can be set. If no type is given, it will be assumed that the input doesn't need to be changed.\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        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        # The field below requires additional information to be set\r\n        $NeedsOptions = \"Dropdown\"\r\n        if ($DocumentName) {\r\n            if ($NeedsOptions -contains $Type) {\r\n                # We'll redirect the error output to the success stream to make it easier to error out if nothing was found or something else went wrong.\r\n                $NinjaPropertyOptions = Ninja-Property-Docs-Options -AttributeName $Name @DocumentationParams 2&gt;&amp;1\r\n            }\r\n        }\r\n        else {\r\n            if ($NeedsOptions -contains $Type) {\r\n                $NinjaPropertyOptions = Ninja-Property-Options -Name $Name 2&gt;&amp;1\r\n            }\r\n        }\r\n        \r\n        # If an error is received it will have an exception property, the function will exit with that error information.\r\n        if ($NinjaPropertyOptions.Exception) { throw $NinjaPropertyOptions }\r\n        \r\n        # The below type's require values not typically given in order to be set. The below code will convert whatever we're given into a format ninjarmm-cli supports.\r\n        switch ($Type) {\r\n            \"Checkbox\" {\r\n                # While it's highly likely we were given a value like \"True\" or a boolean datatype it's better to be safe than sorry.\r\n                $NinjaValue = [System.Convert]::ToBoolean($Value)\r\n            }\r\n            \"Date or Date Time\" {\r\n                # Ninjarmm-cli expects the  Date-Time to be in Unix Epoch time so we'll convert it here.\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                # Ninjarmm-cli is expecting the guid of the option we're trying to select. So we'll match up the value we were given with a 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                if (-not $Selection) {\r\n                    throw [System.ArgumentOutOfRangeException]::New(\"Value is not present in dropdown\")\r\n                }\r\n        \r\n                $NinjaValue = $Selection\r\n            }\r\n            default {\r\n                # All the other types shouldn't require additional work on the input.\r\n                $NinjaValue = $Value\r\n            }\r\n        }\r\n        \r\n        # We'll need to set the field differently depending on if its a field in a Ninja Document or not.\r\n        if ($DocumentName) {\r\n            $CustomField = Ninja-Property-Docs-Set -AttributeName $Name -AttributeValue $NinjaValue @DocumentationParams 2&gt;&amp;1\r\n        }\r\n        else {\r\n            $CustomField = Ninja-Property-Set -Name $Name -Value $NinjaValue 2&gt;&amp;1\r\n        }\r\n        \r\n        if ($CustomField.Exception) {\r\n            throw $CustomField\r\n        }\r\n    }\r\n\r\n    $ExitCode = 0\r\n}\r\nprocess {\r\n    # Error out if local administrator rights are not present.\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Host \"[Error] Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    # Initialize generic lists.\r\n    $SearchJobs = New-Object System.Collections.Generic.List[object]\r\n    $CustomFieldValue = New-Object System.Collections.Generic.List[string]\r\n\r\n    # For each given path to search, create a PowerShell job with the provided parameters.\r\n    $PathsToSearch | ForEach-Object {\r\n        $SearchJobs.Add(\r\n            (\r\n                Start-Job -ScriptBlock {\r\n                    param($SearchPath, $FileOrFolder, $SearchType)\r\n                    # We're going to wildcard search either files or folders depending on the parameters given.\r\n                    switch ($SearchType) {\r\n                        \"Files and Folders\" {\r\n                            Get-ChildItem -Path $SearchPath -Filter \"*$FileOrFolder*\" -Recurse | Select-Object -Property FullName, Attributes | ConvertTo-Csv\r\n                        }\r\n                        \"Folders Only\" {\r\n                            Get-ChildItem -Path $SearchPath -Filter \"*$FileOrFolder*\" -Recurse -Directory | Select-Object -Property FullName, Attributes | ConvertTo-Csv\r\n                        }\r\n                        \"Files Only\" { \r\n                            Get-ChildItem -Path $SearchPath -Filter \"*$FileOrFolder*\" -Recurse -File | Select-Object FullName, Attributes | ConvertTo-Csv\r\n                        }\r\n                    }\r\n                } -ArgumentList $_, $FileOrFolder, $SearchType\r\n            )\r\n        )\r\n    }\r\n\r\n    # Convert timeout to seconds as Wait-Job requires seconds.\r\n    $TimeoutInSeconds = $Timeout * 60\r\n    $StartTime = Get-Date\r\n\r\n    # Wait for all jobs to complete or timeout.\r\n    foreach ($SearchJob in $SearchJobs) {\r\n        # Calculate the remaining time.\r\n        $TimeElapsed = (Get-Date) - $StartTime\r\n        $RemainingTime = $TimeoutInSeconds - $TimeElapsed.TotalSeconds\r\n    \r\n        # If there is no remaining time, break the loop.\r\n        if ($RemainingTime -le 0) {\r\n            break\r\n        }\r\n    \r\n        # Wait for the current job with the remaining time as the timeout.\r\n        $SearchJob | Wait-Job -Timeout $RemainingTime | Out-Null\r\n    }\r\n\r\n    # Output a warning if the job fails to complete.\r\n    $IncompleteJobs = $SearchJobs | Get-Job | Where-Object { $_.State -eq \"Running\" }\r\n    if ($IncompleteJobs) {\r\n        Write-Host \"[Error] The timeout period of $Timeout minutes has been reached, but not all files or directories have been searched!\"\r\n        $CustomFieldValue.Add(\"[Error] The timeout period of $Timeout minutes has been reached, but not all files or directories have been searched!\")\r\n        $ExitCode = 1\r\n    }\r\n\r\n    # Our PowerShell Job outputs in CSV format; we'll convert it here.\r\n    $MatchingItems = $SearchJobs | ForEach-Object {\r\n        $_ | Get-Job | Receive-Job -ErrorAction SilentlyContinue -ErrorVariable JobErrors | ConvertFrom-Csv\r\n    }\r\n\r\n    # Identify whether or not we have a match for a file or folder here.\r\n    $FileMatch = $MatchingItems | Where-Object { $_.Attributes -ne \"Directory\" }\r\n    $FolderMatch = $MatchingItems | Where-Object { $_.Attributes -eq \"Directory\" }\r\n\r\n    # If we have a match for a file we'll output that here.\r\n    if ($FileMatch) { \r\n        Write-Host -Object \"[Alert] File Found.\"\r\n        $CustomFieldValue.Add(\"[Alert] File Found.\")\r\n    }\r\n\r\n    # If we have a match for a folder we'll output that here.\r\n    if ($FolderMatch) { \r\n        Write-Host -Object \"[Alert] Folder Found.\" \r\n        $CustomFieldValue.Add(\"[Alert] Folder Found.\")\r\n    }\r\n\r\n    # If we have no matches we'll output that here.\r\n    if (-not $FileMatch -and -not $FolderMatch) {\r\n        Write-Host -Object \"Unable to find $FileOrFolder.\"\r\n        $CustomFieldValue.Add(\"Unable to find $FileOrFolder.\")\r\n    }\r\n\r\n    # For each matching file we'll output their full path.\r\n    $MatchingItems | ForEach-Object { \r\n        Write-Host \"$($_.FullName)\"\r\n        $CustomFieldValue.Add(\"$($_.FullName)\") \r\n    }\r\n\r\n    # Output any failures or errors received.\r\n    $FailedJobs = $SearchJobs | Get-Job | Where-Object { $_.State -ne \"Completed\" -and $_.State -ne \"Running\" }\r\n    if ($FailedJobs -or $JobErrors) {\r\n        Write-Host \"\"\r\n        Write-Host \"[Error] Failed to search certain files or directories due to an error.\"\r\n\r\n        $CustomFieldValue.Add(\"\")\r\n        $CustomFieldValue.Add(\"[Error] Failed to search certain files or directories due to an error.\")\r\n        if ($JobErrors) {\r\n            Write-Host \"\"\r\n            $CustomFieldValue.Add(\"\")\r\n\r\n            $JobErrors | ForEach-Object { \r\n                Write-Host \"[Error] $($_.Exception.Message)\" \r\n                $CustomFieldValue.Add(\"[Error] $($_.Exception.Message)\")\r\n            }\r\n        }\r\n        $ExitCode = 1\r\n    }\r\n\r\n    $SearchJobs | Get-Job | Remove-Job -Force\r\n\r\n    # Attempt to set the custom field using the Set-NinjaProperty function, if provided.\r\n    if ($CustomField) {\r\n        try {\r\n            Write-Host \"Attempting to set Custom Field '$CustomField'.\"\r\n            Set-NinjaProperty -Name $CustomField -Value ($CustomFieldValue | Out-String)\r\n            Write-Host \"Successfully set Custom Field '$CustomField'!\"\r\n        }\r\n        catch {\r\n            if (-not $_.Exception.Message) {\r\n                Write-Host \"[Error] $($_.Message)\"\r\n            }\r\n            else {\r\n                Write-Host \"[Error] $($_.Exception.Message)\"\r\n            }\r\n            $ExitCode = 1\r\n        }\r\n    }\r\n\r\n    exit $ExitCode\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}<\/pre>\n<p>&nbsp;<\/p>\n\n<div class=\"blog-cta-new blog-cta-style-1\"><div class=\"cta-left\"><h2><\/h2><p><\/p><\/div><div class=\"cta-right\"><a class=\"button\" href=\"\"><\/a><\/div><\/div>\n<h2>Description d\u00e9taill\u00e9e<\/h2>\n<p>Le script fonctionne en plusieurs \u00e9tapes, chacune contribuant \u00e0 sa fonctionnalit\u00e9 globale. En voici la description \u00e9tape par \u00e9tape\u00a0:<\/p>\n<p><strong>1. Initialisation des param\u00e8tres<\/strong>\u00a0: Le script commence par d\u00e9finir plusieurs param\u00e8tres :<\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"1\" data-aria-level=\"2\">SearchPath: Les r\u00e9pertoires \u00e0 rechercher.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"2\" data-aria-level=\"2\">FileOrFolder : Le nom du fichier ou du dossier \u00e0 rechercher.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"3\" data-aria-level=\"2\">SearchType: Recherche de fichiers, de dossiers ou des deux.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"4\" data-aria-level=\"2\">Timeout: Dur\u00e9e maximale de la recherche.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"5\" data-aria-level=\"2\">CustomField: Un champ facultatif pour enregistrer les r\u00e9sultats de la recherche.<\/li>\n<\/ul>\n<p><strong>2. Remplacement des variables d&rsquo;environnement<\/strong>: Le script v\u00e9rifie si des variables d&rsquo;environnement sont d\u00e9finies et doivent remplacer les param\u00e8tres d&rsquo;entr\u00e9e. Cela permet des ajustements dynamiques en fonction des diff\u00e9rents environnements.<\/p>\n<p><strong>3. Validation<\/strong>\u00a0: Le script effectue plusieurs contr\u00f4les de validation :<\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"6\" data-aria-level=\"2\">S&rsquo;assurer qu&rsquo;un chemin de recherche est fourni.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"7\" data-aria-level=\"2\">Validation et formatage du chemin de recherche.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"8\" data-aria-level=\"2\">V\u00e9rifier l&rsquo;existence des chemins sp\u00e9cifi\u00e9s.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"9\" data-aria-level=\"2\">Validation du nom du fichier ou du dossier.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"10\" data-aria-level=\"2\">S&rsquo;assurer que la valeur du d\u00e9lai d&rsquo;attente se situe dans une fourchette acceptable.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"11\" data-aria-level=\"2\">Confirmation de la validit\u00e9 du type de recherche.<\/li>\n<\/ul>\n<p><strong>4. V\u00e9rification des droits de l&rsquo;administrateur<\/strong>: Le script comprend une fonction permettant de v\u00e9rifier s&rsquo;il est ex\u00e9cut\u00e9 avec des privil\u00e8ges d&rsquo;administrateur, ce qui est n\u00e9cessaire pour certaines op\u00e9rations sur les fichiers.<\/p>\n<p><strong>5. Ex\u00e9cution de la recherche<\/strong>: La fonctionnalit\u00e9 principale consiste \u00e0 cr\u00e9er des t\u00e2ches PowerShell pour chaque chemin \u00e0 rechercher. Ces t\u00e2ches effectuent des recherches r\u00e9cursives sur la base des param\u00e8tres sp\u00e9cifi\u00e9s et renvoient les r\u00e9sultats au format CSV.<\/p>\n<p><strong>6. Traitement des r\u00e9sultats<\/strong>: Le script recueille et traite les r\u00e9sultats de la recherche :<\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"12\" data-aria-level=\"2\">Il identifie les correspondances pour les fichiers et les dossiers.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"13\" data-aria-level=\"2\">Produit les chemins complets de tous les \u00e9l\u00e9ments correspondants.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:1440,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"14\" data-aria-level=\"2\">Erreurs d&rsquo;enregistrement ou recherches incompl\u00e8tes.<\/li>\n<\/ul>\n<p><strong>7. R\u00e9glage du champ personnalis\u00e9<\/strong>: Si un champ personnalis\u00e9 est sp\u00e9cifi\u00e9, le script tente de le d\u00e9finir avec les r\u00e9sultats de la recherche, en s&rsquo;appuyant sur une fonction d&rsquo;aide pour g\u00e9rer les diff\u00e9rents types de champs.<\/p>\n<p><strong>8. Gestion des erreurs et nettoyage<\/strong>: Le script s&rsquo;assure que toutes les erreurs sont enregistr\u00e9es et que tous les travaux sont correctement nettoy\u00e9s avant de se terminer avec un code de sortie appropri\u00e9.<\/p>\n<h2>Cas d&rsquo;utilisation potentiels<\/h2>\n<p>Prenons l&rsquo;exemple d&rsquo;un professionnel de l&rsquo;informatique qui g\u00e8re un r\u00e9seau de postes de travail pour le compte d&rsquo;une entreprise cliente. Ils doivent s&rsquo;assurer qu&rsquo;aucun fichier ex\u00e9cutable non autoris\u00e9 n&rsquo;est pr\u00e9sent dans les r\u00e9pertoires des utilisateurs, dans le cadre d&rsquo;un audit de s\u00e9curit\u00e9. En d\u00e9ployant ce script, ils peuvent automatiser la recherche sur tous les postes de travail, identifier rapidement toutes les occurrences de fichiers non autoris\u00e9s et prendre les mesures n\u00e9cessaires. Cette automatisation permet non seulement de renforcer la s\u00e9curit\u00e9, mais aussi de lib\u00e9rer un temps pr\u00e9cieux pour que l&rsquo;\u00e9quipe informatique se concentre sur des t\u00e2ches plus strat\u00e9giques.<\/p>\n<h2>Comparaisons<\/h2>\n<p>Ce script offre une approche compl\u00e8te et automatis\u00e9e de la recherche de fichiers et de dossiers par rapport aux m\u00e9thodes manuelles ou aux scripts batch de base. Les m\u00e9thodes traditionnelles impliquent souvent une navigation manuelle dans les r\u00e9pertoires ou l&rsquo;utilisation de scripts simples d\u00e9pourvus de fonctions avanc\u00e9es telles que la gestion des d\u00e9lais, l&rsquo;enregistrement de champs personnalis\u00e9s et l&rsquo;ex\u00e9cution de t\u00e2ches multithread. La capacit\u00e9 du script PowerShell \u00e0 g\u00e9rer des environnements complexes et \u00e0 fournir des r\u00e9sultats d\u00e9taill\u00e9s en fait un choix de premier ordre pour les professionnels de l&rsquo;informatique.<\/p>\n<h2>FAQ<\/h2>\n<h3>1) Comment puis-je sp\u00e9cifier plusieurs r\u00e9pertoires pour la recherche ?<\/h3>\n<p>Utilisez une liste s\u00e9par\u00e9e par des virgules pour le param\u00e8tre SearchPath, par exemple \u00ab\u00a0C:NPath1,C:NPath2\u00a0\u00bb.<\/p>\n<h3>2) Puis-je limiter la recherche aux fichiers ou aux dossiers ?<\/h3>\n<p>Oui, utilisez le param\u00e8tre SearchType avec les valeurs \u00ab\u00a0Files Only\u00a0\u00bb ou \u00ab\u00a0Folders Only\u00a0\u00bb.<\/p>\n<h3>3) Que se passe-t-il si la recherche d\u00e9passe le d\u00e9lai sp\u00e9cifi\u00e9 ?<\/h3>\n<p>Le script mettra fin \u00e0 toute recherche incompl\u00e8te et enregistrera un message d&rsquo;erreur.<\/p>\n<h3>4) Ai-je besoin de privil\u00e8ges d&rsquo;administrateur pour ex\u00e9cuter ce script ?<\/h3>\n<p>Oui, le script v\u00e9rifie les droits d&rsquo;administrateur et se termine s&rsquo;il n&rsquo;est pas ex\u00e9cut\u00e9 avec des privil\u00e8ges suffisants.<\/p>\n<h2>Implications<\/h2>\n<p>Les r\u00e9sultats de ce script ont des implications importantes pour la s\u00e9curit\u00e9 informatique. En identifiant les fichiers et dossiers non autoris\u00e9s ou \u00e9gar\u00e9s, les professionnels de l&rsquo;informatique peuvent prendre des mesures imm\u00e9diates pour att\u00e9nuer les risques potentiels en mati\u00e8re de s\u00e9curit\u00e9. L&rsquo;ex\u00e9cution r\u00e9guli\u00e8re de ce script dans le cadre d&rsquo;une routine de maintenance peut contribuer \u00e0 garantir la conformit\u00e9 avec les politiques de l&rsquo;organisation et les exigences r\u00e9glementaires, am\u00e9liorant ainsi la posture de s\u00e9curit\u00e9 globale.<\/p>\n<h2>Recommandations<\/h2>\n<p>Lors de l&rsquo;utilisation de ce script, il est important de suivre les bonnes pratiques suivantes :<\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"2\" data-aria-level=\"1\">Mettez r\u00e9guli\u00e8rement le script \u00e0 jour pour tenir compte des changements dans votre environnement.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"3\" data-aria-level=\"1\">Int\u00e9grez le script dans des routines de maintenance automatis\u00e9es.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"4\" data-aria-level=\"1\">Examinez les r\u00e9sultats de la recherche et agissez rapidement pour maintenir la s\u00e9curit\u00e9.<\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"5\" data-aria-level=\"1\">Personnalisez les param\u00e8tres du script pour r\u00e9pondre \u00e0 des besoins et \u00e0 des environnements sp\u00e9cifiques.<\/li>\n<\/ul>\n<h2>Conclusion<\/h2>\n<p>Ce script PowerShell est un outil puissant pour les professionnels de l&rsquo;informatique, offrant des capacit\u00e9s de recherche de fichiers et de dossiers automatis\u00e9es et efficaces. En exploitant ce script, les \u00e9quipes informatiques peuvent am\u00e9liorer <a href=\"https:\/\/www.ninjaone.com\/fr\/efficacite\" target=\"_blank\" rel=\"noopener\">leur efficacit\u00e9 op\u00e9rationnelle<\/a>, <a href=\"https:\/\/www.ninjaone.com\/fr\/top-5-des-principes-fondamentaux-de-securite-informatique\" target=\"_blank\" rel=\"noopener\">maintenir la s\u00e9curit\u00e9<\/a> et assurer la conformit\u00e9 avec les politiques de l&rsquo;organisation. Pour ceux qui utilisent NinjaOne, l&rsquo;int\u00e9gration de ce script peut rationaliser davantage les t\u00e2ches de gestion, en permettant un contr\u00f4le et une surveillance centralis\u00e9s sur plusieurs terminaux.<\/p>\n","protected":false},"author":35,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"","_lmt_disable":""},"operating_system":[4212],"use_cases":[4285],"class_list":["post-353650","script_hub","type-script_hub","status-publish","hentry","script_hub_category-windows"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/script_hub\/353650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/script_hub"}],"about":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/types\/script_hub"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/comments?post=353650"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/media?parent=353650"}],"wp:term":[{"taxonomy":"script_hub_category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/operating_system?post=353650"},{"taxonomy":"use_cases","embeddable":true,"href":"https:\/\/www.ninjaone.com\/fr\/wp-json\/wp\/v2\/use_cases?post=353650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}