Test-Path

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>]

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.

Test-Path -Path "C:\Documents and Settings\DavidC"

True

Mit 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.

Test-Path -Path $PROFILE

False

Test-Path -Path $PROFILE -IsValid

True

Diese Befehle testen den Pfad des PowerShell-Profils.

Der erste Befehl bestimmt, ob alle Elemente im Pfad vorhanden sind. Der zweite Befehl bestimmt, ob die Syntax des Pfads korrekt 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.

Test-Path -Path "C:\CAD\Commercial Buildings\*" -Exclude *.dwg

False

Mit 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 Geschäftsgebäudeverzeichnisses 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 .

Test-Path -Path $PROFILE -PathType Leaf

True

Mit diesem Befehl wird überprüft, ob der in der $PROFILE Variablen gespeicherte Pfad zu einer Datei führt. In diesem Fall gibt das Cmdlet .ps1zurück, da das PowerShell-Profil eine $true Datei ist.

Diese Befehle werden mit dem PowerShell-Registrierungsanbieter verwendet Test-Path .

Der erste Befehl testet, ob der Registrierungspfad des Microsoft. PowerShell Registrierungsschlüssel ist auf dem System korrekt. Wenn PowerShell ordnungsgemäß installiert ist, wird das Cmdlet zurückgegeben $true.

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell"

True

Test-Path -Path "HKLM:\Software\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell\ExecutionPolicy"

False

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"

True

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.TestPathCommand

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
False

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
True

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können eine Zeichenfolge, die einen Pfad, aber keinen wörtlichen Pfad enthält, an dieses Cmdlet weiterleiten.

Das Cmdlet gibt einen booleschen Wert zurück.

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 Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.