Test-Path
Détermine si tous les éléments d'un chemin d'accès existent.
Syntaxe
Test-Path
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[-UseTransaction]
[-OlderThan <datetime>]
[-NewerThan <datetime>]
[<CommonParameters>]Test-Path
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[-UseTransaction]
[-OlderThan <datetime>]
[-NewerThan <datetime>]
[<CommonParameters>]Test-Path
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]Test-Path
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[-UseTransaction]
[<CommonParameters>]Description
L’applet Test-Path de commande détermine si tous les éléments du chemin existent. Elle retourne $true si tous les éléments existent et $false s’ils sont manquants. Il peut également indiquer si la syntaxe du chemin d’accès est valide et si le chemin mène à un conteneur ou à un terminal ou un élément feuille. Si le chemin d’accès est un espace blanc ou une chaîne vide, l’applet de commande retourne $false. Si le chemin d’accès est $null, tableau de tableau ou tableau vide, l’applet de $null commande retourne une erreur sans fin.
Exemples
Exemple 1 : Tester un chemin d’accès
Test-Path -Path "C:\Documents and Settings\DavidC"
TrueCette commande vérifie si tous les éléments du chemin d’accès existent, y compris le C: répertoire, le Documents and Settings répertoire et le DavidC répertoire. Le cas échéant, l’applet de commande retourne $false. Sinon, $trueest retourné.
Exemple 2 : Tester le chemin d’accès d’un profil
Test-Path -Path $profile
False
Test-Path -Path $profile -IsValid
TrueCes commandes testent le chemin d’accès du profil PowerShell.
La première commande détermine si tous les éléments du chemin d'accès existent. La deuxième commande détermine si la syntaxe du chemin d'accès est correcte. Dans ce cas, le chemin d’accès est $false, mais la syntaxe est correcte $true. Ces commandes utilisent $profilela variable automatique qui pointe vers l’emplacement du profil, même si le profil n’existe pas.
Pour plus d’informations sur les variables automatiques, consultez about_Automatic_Variables.
Exemple 3 : Vérifier s’il existe des fichiers en plus d’un type spécifié
Test-Path -Path "C:\CAD\Commercial Buildings\*" -Exclude *.dwg
FalseCette commande vérifie s’il existe des fichiers dans le répertoire Bâtiments commerciaux autres que les fichiers .dwg.
La commande utilise le paramètre Path pour spécifier le chemin d’accès. Étant donné que le chemin inclut un espace, le chemin est placé entre guillemets. L'astérisque situé à la fin du chemin d'accès indique le contenu du répertoire Commercial Building. Avec des chemins longs, tels que celui-ci, tapez les premières lettres du chemin, puis utilisez la touche TAB pour terminer le chemin.
La commande spécifie le paramètre Exclude pour spécifier les fichiers à omettre de l’évaluation.
Dans ce cas, étant donné que le répertoire contient uniquement .dwg fichiers, le résultat est $false.
Exemple 4 : Rechercher un fichier
Test-Path -Path $profile -PathType leaf
TrueCette commande vérifie si le chemin stocké dans la $profile variable conduit à un fichier. Dans ce cas, étant donné que le profil PowerShell est un .ps1 fichier, l’applet de commande retourne $true.
Exemple 5 : Vérifier les chemins d’accès dans le Registre
Ces commandes s’utilisent Test-Path avec le fournisseur de Registre PowerShell.
La première commande teste si le chemin du Registre de la clé de Registre Microsoft.PowerShell est correct sur le système. Si PowerShell est installé correctement, l’applet de commande retourne $true.
Important
Test-Path ne fonctionne pas correctement avec tous les fournisseurs PowerShell. Par exemple, vous pouvez utiliser Test-Path pour tester le chemin d’accès d’une clé de Registre, mais si vous l’utilisez pour tester le chemin d’une entrée de Registre, il retourne $falsetoujours , même si l’entrée de Registre est présente.
Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell"
True
Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell\ExecutionPolicy"
FalseExemple 6 : Tester si un fichier est plus récent qu’une date spécifiée
Cette commande utilise le paramètre dynamique NewerThan pour déterminer si le PowerShell.exe fichier sur l’ordinateur est plus récent que July 13, 2009.
Le paramètre NewerThan fonctionne uniquement dans les lecteurs du système de fichiers.
Test-Path $pshome\PowerShell.exe -NewerThan "July 13, 2009"
TrueExemple 7 : Tester un chemin d’accès avec null comme valeur
L’erreur retournée pour null, tableau de null tableau ou tableau vide est une erreur sans fin. Il peut être supprimé à l’aide -ErrorAction SilentlyContinuede . L’exemple suivant montre tous les cas qui retournent l’erreur NullPathNotPermitted .
Test-Path $null
Test-Path $null, $null
Test-Path @()
Test-Path : Cannot bind argument to parameter 'Path' because it is null.
At line:1 char:11
+ Test-Path $null
+ ~~~~~
+ CategoryInfo : InvalidData: (:) [Test-Path], ParameterBindingValidationException
+ FullyQualifiedErrorId : ParameterArgumentValidationErrorNullNotAllowed,Microsoft.PowerShell.Commands.TestPathCommandExemple 8 : Tester un chemin avec un espace blanc comme valeur
Lorsqu’une chaîne d’espace blanc est fournie pour le paramètre Path , elle retourne $true. Lorsqu’une chaîne vide est fournie, Test-Path retourne une erreur. L’exemple suivant montre un espace blanc et une chaîne vide.
Test-Path ' '
Test-Path ''
True
Test-Path : Cannot bind argument to parameter 'Path' because it is an empty string.
At line:1 char:11
+ Test-Path ''
+ ~~
+ CategoryInfo : InvalidData: (:) [Test-Path], ParameterBindingValidationException
+ FullyQualifiedErrorId : ParameterArgumentValidationErrorEmptyStringNotAllowed,Microsoft.PowerShell.Commands.TestPathCommandExemple 9 : Tester un chemin d’accès qui peut avoir un lecteur non valide
Lorsque vous testez un chemin qui inclut une spécification de lecteur, le test de la validité du chemin échoue si le lecteur n’existe pas. Vous pouvez préfixer le lecteur avec le nom du fournisseur pour contourner ce problème.
Test-Path -IsValid Z:\abc.txt
Test-Path -IsValid FileSystem::Z:\abc.txt
False
TrueParamètres
-Credential
Remarque
Ce paramètre n’est pas pris en charge par les fournisseurs installés avec PowerShell. Pour emprunter l’identité d’un autre utilisateur ou élever vos informations d’identification lors de l’exécution de cette applet de commande, utilisez Invoke-Command.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Exclude
Spécifie les éléments omis par cette applet de commande. La valeur de ce paramètre qualifie le paramètre Path . Entrez un élément ou un modèle de chemin d’accès, tel que *.txt. Les caractères génériques sont autorisés.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Filter
Spécifie un filtre dans le format ou la langue du fournisseur. La valeur de ce paramètre qualifie le paramètre Path . La syntaxe du filtre, y compris l’utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que d’autres paramètres, car le fournisseur les applique lorsqu’il récupère les objets au lieu d’avoir PowerShell filtrer les objets après leur récupération.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Include
Spécifie les chemins d’accès que cette applet de commande teste. La valeur de ce paramètre qualifie le paramètre Path . Entrez un élément ou un modèle de chemin d’accès, tel que *.txt. Les caractères génériques sont autorisés.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-IsValid
Indique que cette applet de commande teste la syntaxe du chemin d’accès, que les éléments du chemin d’accès existent. Cette applet de commande retourne $true si la syntaxe du chemin d’accès est valide et $false si ce n’est pas le cas. Si le chemin d’accès testé inclut une spécification de lecteur, l’applet de commande retourne false lorsque le lecteur n’existe pas. PowerShell retourne false, car il ne sait pas quel fournisseur de lecteurs tester.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LiteralPath
Spécifie un chemin d’accès à vérifier. Contrairement à Path, la valeur du paramètre LiteralPath est utilisée exactement comme elle est typée. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin inclut des caractères qui peuvent être interprétés par PowerShell comme séquences d’échappement, vous devez placer le chemin dans un guillemet unique afin qu’ils ne soient pas interprétés.
| Type: | String[] |
| Alias: | PSPath |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-NewerThan
Il s’agit d’un paramètre dynamique mis à disposition par le fournisseur FileSystem .
Spécifiez une heure en tant qu’objet DateTime .
Avant PowerShell 7.5, l’applet de commande ignore :
- Ce paramètre lorsque vous spécifiez PathType comme valeur autre que
Any. - Paramètre OlderThan lorsqu’il est utilisé avec ce paramètre.
- Ce paramètre lorsque Path pointe vers un répertoire.
À compter de PowerShell 7.5, vous pouvez utiliser ce paramètre avec n’importe quelle valeur pour le paramètre PathType , pour tester une plage de dates avec le paramètre OlderThan et tester l’âge des répertoires.
Pour plus d’informations, consultez about_FileSystem_Provider.
| Type: | Nullable<T>[[DateTime]] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OlderThan
Il s’agit d’un paramètre dynamique mis à disposition par le fournisseur FileSystem .
Spécifiez une heure en tant qu’objet DateTime .
Avant PowerShell 7.5, l’applet de commande ignore :
- Ce paramètre lorsque vous spécifiez PathType comme valeur autre que
Any. - Ce paramètre est utilisé avec le paramètre NewerThan .
- Ce paramètre lorsque Path pointe vers un répertoire.
À compter de PowerShell 7.5, vous pouvez utiliser ce paramètre avec n’importe quelle valeur pour le paramètre PathType , pour tester une plage de dates avec le paramètre NewerThan et tester l’âge des répertoires.
Pour plus d’informations, consultez about_FileSystem_Provider.
| Type: | Nullable<T>[[DateTime]] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Path
Spécifie un chemin d’accès à vérifier. Les caractères génériques sont autorisés. Si le chemin d’accès inclut des espaces, mettez-le entre guillemets.
| Type: | String[] |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | True |
-PathType
Spécifie le type de l’élément final dans le chemin d’accès. Cette applet de commande retourne $true si l’élément est du type spécifié et $false s’il ne l’est pas. Les valeurs valides pour ce paramètre sont :
Container- Élément qui contient d’autres éléments, tels qu’un répertoire ou une clé de Registre.Leaf- Élément qui ne contient pas d’autres éléments, tels qu’un fichier.Any- Un conteneur ou une feuille.
Indique si le dernier élément figurant dans le chemin d’accès est d’un type particulier.
Attention
Jusqu’à PowerShell version 6.1.2, lorsque les commutateurs IsValid et PathType sont spécifiés ensemble, l’applet Test-Path de commande ignore le commutateur PathType et valide uniquement le chemin d’accès syntaxique sans valider le type de chemin.
Selon le problème #8607, la résolution de ce comportement peut être un changement cassant dans une version ultérieure, où les commutateurs IsValid et PathType appartiennent à des jeux de paramètres distincts, et par conséquent, ne peuvent pas être utilisés ensemble pour éviter cette confusion.
| Type: | TestPathType |
| Alias: | Type |
| Valeurs acceptées: | Any, Container, Leaf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est uniquement valide au cours d’une transaction. Pour plus d’informations, consultez about_Transactions
| Type: | SwitchParameter |
| Alias: | usetx |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger une chaîne qui contient un chemin d’accès, mais pas un chemin littéral, vers cette applet de commande.
Sorties
L’applet de commande retourne une valeur booléenne .
Notes
Les applets de commande qui contiennent le nom Path (applets de commande Path) fonctionnent avec le chemin d’accès et retournent les noms dans un format concis que tous les fournisseurs PowerShell peuvent interpréter. Ils sont conçus pour être utilisés dans les programmes et les scripts dans lesquels vous souhaitez afficher tout ou partie d’un chemin d’accès dans un format particulier. Utilisez-les comme vous le feriez avec Dirname, Normpath, Realpath, Join ou d’autres manipulateurs de chemin d’accès.
Il Test-Path est conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PSProvider. Pour plus d’informations, consultez about_Providers.
