Test-Path
Bestimmt, ob alle Elemente eines Pfads vorhanden sind.
Syntax
Test-Path
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <PSCredential>]
[-OlderThan <DateTime>]
[-NewerThan <DateTime>]
[<CommonParameters>]Test-Path
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <PSCredential>]
[-OlderThan <DateTime>]
[-NewerThan <DateTime>]
[<CommonParameters>]Test-Path
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[<CommonParameters>]Test-Path
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-PathType <TestPathType>]
[-IsValid]
[-Credential <pscredential>]
[<CommonParameters>]Beschreibung
Das Test-Path Cmdlet bestimmt, ob alle Elemente des Pfads vorhanden sind. Es wird zurückgegeben $true , wenn alle Elemente vorhanden sind und $false fehlen. Es kann auch feststellen, ob die Pfadsyntax gültig ist und ob der Pfad zu einem Container oder zu einem Terminal- oder Blattelement führt. Wenn der Pfad ein Leerzeichen oder eine leere Zeichenfolge ist, wird das Cmdlet zurückgegeben $false. Wenn es sich bei dem Pfad$nullum ein Array oder $null ein leeres Array handelt, gibt das Cmdlet einen nicht beendeten Fehler zurück.
Beispiele
Beispiel 1: Testen eines Pfads
Test-Path -Path "C:\Documents and Settings\DavidC"
TrueMit diesem Befehl wird überprüft, ob alle Elemente im Pfad vorhanden sind, einschließlich des C: Verzeichnisses, des Documents and Settings Verzeichnisses und des Verzeichnisses DavidC . Wenn ein Wert fehlt, gibt das Cmdlet zurück $false. Andernfalls wird $truezurückgegeben.
Beispiel 2: Testen des Pfads eines Profils
Test-Path -Path $profile
False
Test-Path -Path $profile -IsValid
TrueDiese Befehle testen den Pfad des PowerShell-Profils.
Mit dem ersten Befehl wird bestimmt, ob alle Elemente im Pfad vorhanden sind. Mit dem zweiten Befehl wird bestimmt, ob die Syntax des Pfads gültig ist. In diesem Fall lautet $falseder Pfad , aber die Syntax ist richtig $true. Diese Befehle verwenden $profiledie automatische Variable, die auf die Position für das Profil verweist, auch wenn das Profil nicht vorhanden ist.
Weitere Informationen zu automatischen Variablen finden Sie unter about_Automatic_Variables.
Beispiel 3: Überprüfen, ob neben einem angegebenen Typ Dateien vorhanden sind
Test-Path -Path "C:\CAD\Commercial Buildings\*" -Exclude *.dwg
FalseMit diesem Befehl wird überprüft, ob im Verzeichnis "Gewerbegebäude" andere Dateien als .dwg Dateien vorhanden sind.
Der Befehl verwendet den Path-Parameter , um den Pfad anzugeben. Da der Pfad ein Leerzeichen enthält, wird der Pfad in Anführungszeichen eingeschlossen. Das Sternchen am Ende des Pfads gibt den Inhalt des Verzeichnisses %%amp;quot;Commercial Building%%amp;quot; an. Geben Sie bei langen Pfaden, z. B. dieser, die ersten Buchstaben des Pfads ein, und verwenden Sie dann die TAB-TASTE, um den Pfad abzuschließen.
Der Befehl gibt den Parameter Exclude an, um Dateien anzugeben, die aus der Auswertung weggelassen werden sollen.
In diesem Fall, da das Verzeichnis nur .dwg Dateien enthält, lautet $falsedas Ergebnis .
Beispiel 4: Suchen nach einer Datei
Test-Path -Path $profile -PathType leaf
TrueMit diesem Befehl wird überprüft, ob der in der $profile Variablen gespeicherte Pfad zu einer Datei führt. In diesem Fall gibt das Cmdlet $truezurück, da das PowerShell-Profil eine .ps1 Datei ist.
Beispiel 5: Überprüfen von Pfaden in der Registrierung
Diese Befehle werden mit dem PowerShell-Registrierungsanbieter verwendet Test-Path .
Der erste Befehl testet, ob der Registrierungspfad des Microsoft.PowerShell-Registrierungsschlüssels auf dem System korrekt ist. Wenn PowerShell ordnungsgemäß installiert ist, wird das Cmdlet zurückgegeben $true.
Wichtig
Test-Path funktioniert nicht ordnungsgemäß mit allen PowerShell-Anbietern. Beispielsweise können Test-Path Sie den Pfad eines Registrierungsschlüssels testen, aber wenn Sie ihn zum Testen des Pfads eines Registrierungseintrags verwenden, wird er immer zurückgegeben $false, auch wenn der Registrierungseintrag vorhanden ist.
Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell"
True
Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell\ExecutionPolicy"
FalseBeispiel 6: Testen, ob eine Datei neuer als ein angegebenes Datum ist
Mit diesem Befehl wird der dynamische Parameter NewerThan verwendet, um zu bestimmen, ob die pwsh.exe Datei auf dem Computer neuer July 13, 2009als ist.
Der Parameter NewerThan funktioniert nur auf Dateisystemlaufwerken.
Test-Path $pshome\pwsh.exe -NewerThan "July 13, 2009"
TrueBeispiel 7: Testen eines Pfads mit NULL als Wert
Der für array of null or empty array zurückgegebene nullFehler ist ein nicht beendeter Fehler. Sie kann mithilfe von -ErrorAction SilentlyContinue. Das folgende Beispiel zeigt alle Fälle, in denen der NullPathNotPermitted Fehler zurückgegeben wird.
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.TestPathCommandBeispiel 8: Testen eines Pfads mit Leerzeichen als Wert
Wenn eine Leerzeichenzeichenfolge für den Path-Parameter bereitgestellt wird, wird sie zurückgegeben $false. Dies ist eine Änderung von Windows PowerShell 5.1. Wenn eine leere Zeichenfolge angegeben wird, Test-Path wird ein Fehler zurückgegeben.
Das folgende Beispiel zeigt Leerzeichen und leere Zeichenfolgen.
Test-Path ' '
Test-Path ''
False
FalseBeispiel 9: Testen eines Pfads, der möglicherweise ein ungültiges Laufwerk hat
Wenn Sie einen Pfad testen, der eine Laufwerkspezifikation enthält, schlägt das Testen der Gültigkeit des Pfads fehl, wenn das Laufwerk nicht vorhanden ist. Sie können dem Laufwerk den Anbieternamen voranstellen, um dieses Problem zu umgehen.
Test-Path -IsValid Z:\abc.txt
Test-Path -IsValid FileSystem::Z:\abc.txt
False
TrueParameter
-Credential
Hinweis
Dieser Parameter wird von anbietern, die mit PowerShell installiert sind, nicht unterstützt. Verwenden Sie "Invoke-Command", um die Identität eines anderen Benutzers zu imitieren oder Ihre Anmeldeinformationen beim Ausführen dieses Cmdlets zu erhöhen.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Exclude
Gibt Elemente an, die von diesem Cmdlet weggelassen werden. Der Wert dieses Parameters qualifiziert den Path-Parameter . Geben Sie ein Pfadelement oder Einmuster ein, z *.txt. B. . Platzhalterzeichen sind zulässig.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
Gibt einen Filter im Format oder in der Sprache des Anbieters an. Der Wert dieses Parameters qualifiziert den Path-Parameter . Die Syntax des Filters, einschließlich der Verwendung von Wild Karte Zeichen, hängt vom Anbieter ab. Filter sind effizienter als andere Parameter, da der Anbieter sie anwendet, wenn sie die Objekte abruft, anstatt powerShell nach dem Abrufen der Objekte zu filtern.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Include
Gibt Pfade an, die dieses Cmdlet testet. Der Wert dieses Parameters qualifiziert den Path-Parameter . Geben Sie ein Pfadelement oder Einmuster ein, z *.txt. B. . Platzhalterzeichen sind zulässig.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-IsValid
Gibt an, dass dieses Cmdlet die Syntax des Pfads testet, unabhängig davon, ob die Elemente des Pfads vorhanden sind. Dieses Cmdlet gibt zurück $true , wenn die Pfadsyntax gültig ist und $false nicht. Wenn der getestete Pfad eine Laufwerkspezifikation enthält, gibt das Cmdlet "false" zurück, wenn das Laufwerk nicht vorhanden ist. PowerShell gibt "false" zurück, da er nicht weiß, welcher Laufwerkanbieter getestet werden soll.
Hinweis
Eine bahnbrechende Änderung der Pfad-APIs wurde in .NET 2.1 eingeführt. Diese Methoden suchen nicht mehr nach ungültigen Pfadzeichen. Diese Änderung verursachte eine Regression in PowerShell, bei der die IsValid-Prüfung nicht mehr auf ungültige Zeichen überprüft. Die Regression wird in einer zukünftigen Version behoben. Weitere Informationen finden Sie unter "Grundlegende Änderungen in .NET Core 2.1".
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LiteralPath
Gibt den zu testenden Pfad an. Im Gegensatz zu Path wird der Wert des LiteralPath-Parameters genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Zeichen enthält, die von PowerShell als Escapesequenzen interpretiert werden können, müssen Sie den Pfad in einfache Anführungszeichen setzen, damit sie nicht interpretiert werden.
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NewerThan
Dies ist ein dynamischer Parameter, der vom FileSystem-Anbieter zur Verfügung gestellt wird.
Geben Sie eine Uhrzeit als DateTime-Objekt an.
Vor PowerShell 7.5 ignoriert das Cmdlet Folgendes:
- Dieser Parameter, wenn Sie PathType als einen anderen Wert als
Any. - Der OlderThan-Parameter , wenn er mit diesem Parameter verwendet wird.
- Dieser Parameter, wenn Path auf ein Verzeichnis verweist.
Ab PowerShell 7.5 können Sie diesen Parameter mit einem beliebigen Wert für den PathType-Parameter verwenden, einen Datumsbereich mit dem Parameter OlderThan testen und das Alter von Verzeichnissen testen.
Weitere Informationen finden Sie unter about_FileSystem_Provider.
| Type: | Nullable<T>[[DateTime]] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OlderThan
Dies ist ein dynamischer Parameter, der vom FileSystem-Anbieter zur Verfügung gestellt wird.
Geben Sie eine Uhrzeit als DateTime-Objekt an.
Vor PowerShell 7.5 ignoriert das Cmdlet Folgendes:
- Dieser Parameter, wenn Sie PathType als einen anderen Wert als
Any. - Dieser Parameter, wenn er mit dem Parameter NewerThan verwendet wird.
- Dieser Parameter, wenn Path auf ein Verzeichnis verweist.
Ab PowerShell 7.5 können Sie diesen Parameter mit jedem Wert für den PathType-Parameter verwenden, um einen Datumsbereich mit dem Parameter NewerThan zu testen und das Alter von Verzeichnissen zu testen.
Weitere Informationen finden Sie unter about_FileSystem_Provider.
| Type: | Nullable<T>[[DateTime]] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Gibt den zu testenden Pfad an. Platzhalterzeichen sind zulässig. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen einschließen.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-PathType
Gibt den Typ des endgültigen Elements im Pfad an. Dieses Cmdlet gibt zurück $true , wenn das Element vom angegebenen Typ ist und $false nicht. Zulässige Werte für diesen Parameter:
Container– Ein Element, das andere Elemente enthält, z. B. ein Verzeichnis oder Registrierungsschlüssel.Leaf– Ein Element, das keine anderen Elemente enthält, z. B. eine Datei.Any- Entweder ein Container oder ein Blatt.
Gibt an, ob das letzte Element im Pfad einen bestimmten Typ aufweist.
Achtung
Bis zur PowerShell-Version 6.1.2 ignoriert das Test-Path Cmdlet die Option "PathType", wenn die Switches "IsValid" und "PathType" zusammen angegeben werden, die Option "PathType" und überprüft nur den syntaktischen Pfad, ohne den Pfadtyp zu überprüfen.
Laut Problem Nr. 8607 kann das Beheben dieses Verhaltens eine bahnbrechende Änderung in einer zukünftigen Version sein, bei der die Schalter IsValid und PathType zu separaten Parametersätzen gehören und daher nicht zusammen verwendet werden können, um diese Verwirrung zu vermeiden.
| Type: | TestPathType |
| Aliases: | Type |
| Accepted values: | Any, Container, Leaf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Sie können eine Zeichenfolge, die einen Pfad, aber keinen Literalpfad enthält, an dieses Cmdlet weiterleiten.
Ausgaben
Das Cmdlet gibt einen booleschen Wert zurück.
Hinweise
Die Cmdlets, die das Path-Substantiv (die Pfad-Cmdlets ) enthalten, arbeiten mit dem Pfad und geben die Namen in einem präzisen Format zurück, das von allen PowerShell-Anbietern interpretiert werden kann. Sie sind für die Verwendung in Programmen und Skripts vorgesehen, in denen Sie den gesamten oder einen Teil eines Pfads in einem bestimmten Format anzeigen möchten. Verwenden Sie sie, wie Sie Dirname, Normpath, Realpath, Join oder andere Pfadmanipulationen verwenden würden.
Dies Test-Path ist für die Arbeit mit den Daten vorgesehen, die von jedem Anbieter verfügbar gemacht werden. Geben Sie ein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können Get-PSProvider. Weitere Informationen finden Sie unter about_Providers.
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für