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

De Test-Path cmdlet bepaalt of alle elementen van het pad bestaan. Het retourneert $true als alle elementen bestaan en $false als er een ontbreekt. Er kan ook worden aangegeven of de padsyntaxis geldig is en of het pad naar een container of een terminal- of leaf-element leidt. Als het pad een witruimte of lege tekenreeks is, retourneert de cmdlet $false. Als het pad is $null, retourneert de cmdlet een matrix van $null of een lege matrix, dan geeft de cmdlet een niet-terminale foutmelding terug.

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

True

Met deze opdracht wordt gecontroleerd of alle elementen in het pad bestaan, inclusief de C: map, de Documents and Settings map en de DavidC directory. Als er iets ontbreekt, retourneert de cmdlet $false. Anders retourneert het $true.

Test-Path -Path $PROFILE

False

Test-Path -Path $PROFILE -IsValid

True

Met deze opdrachten wordt het pad van het PowerShell-profiel getest.

Met de eerste opdracht wordt bepaald of alle elementen in het pad bestaan. Met de tweede opdracht wordt bepaald of de syntaxis van het pad juist is. In dit geval is het pad $false, maar de syntaxis is juist $true. Deze opdrachten gebruiken $PROFILE, de automatische variabele die verwijst naar de locatie voor het profiel, zelfs als het profiel niet bestaat.

Zie about_Automatic_Variablesvoor meer informatie over automatische variabelen.

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

False

Met deze opdracht wordt gecontroleerd of er bestanden in de map Commerciële gebouwen staan, behalve .dwg bestanden.

De opdracht gebruikt de parameter Path om het pad op te geven. Omdat het pad een spatie bevat, wordt het pad tussen aanhalingstekens geplaatst. Het sterretje aan het einde van het pad geeft de inhoud van de Commercial Building-directorie aan. Met lange paden, zoals deze, typt u de eerste paar letters van het pad en gebruikt u vervolgens de TAB-toets om het pad te voltooien.

Met de opdracht geeft u de parameter Uitsluiten op om bestanden op te geven die moeten worden weggelaten uit de evaluatie.

Omdat de map alleen .dwg bestanden bevat, wordt het resultaat $false.

Test-Path -Path $PROFILE -PathType Leaf

True

Met deze opdracht wordt gecontroleerd of het pad dat in de $PROFILE variabele is opgeslagen, naar een bestand leidt. In dit geval, omdat het PowerShell-profiel een .ps1 bestand is, retourneert de cmdlet $true.

Deze opdrachten gebruiken Test-Path met de PowerShell-registerprovider.

Met de eerste opdracht wordt getest of het registerpad van de Microsoft.PowerShell registersleutel juist is op het systeem. Als PowerShell correct is geïnstalleerd, retourneert de cmdlet $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

Deze opdracht maakt gebruik van de NewerThan en OlderThan dynamische parameters om te bepalen of het pwsh.exe bestand op de computer nieuwer is dan July 13, 2009 en ouder dan vorige week.

De parameters NewerThan en OlderThan werken alleen in bestandssysteemstations.

Get-Command pwsh |
    Select-Object -ExpandProperty Path |
    Test-Path -NewerThan "July 13, 2009" -OlderThan (Get-Date).AddDays(-7)

True

De geretourneerde fout voor null, array van null of lege array is een niet-beëindigende fout. Het kan worden onderdrukt met behulp van -ErrorAction SilentlyContinue. In het volgende voorbeeld ziet u alle gevallen die de NullPathNotPermitted-fout retourneren.

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

Wanneer er een witruimtetekenreeks wordt opgegeven voor de parameter Path, wordt $falsegeretourneerd. Dit is een wijziging van Windows PowerShell 5.1. Wanneer er een lege tekenreeks wordt opgegeven, retourneert Test-Path een fout. In het volgende voorbeeld ziet u witruimte en lege tekenreeks.

Test-Path ' '
Test-Path ''

False
False

Wanneer u een pad test dat een schijfstationsspecificatie bevat, zal het testen van de geldigheid van het pad mislukken als het schijfstation niet bestaat. U kunt de naam van de provider toevoegen aan het station om dit probleem te omzeilen.

Test-Path -IsValid Z:\abc.txt
Test-Path -IsValid FileSystem::Z:\abc.txt

False
True

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad bevat naar deze cmdlet pijpen, maar niet een letterlijk pad.

De cmdlet retourneert een Booleaanse waarde.

De cmdlets die het Path-zelfstandig naamwoord (de Path cmdlets) bevatten, werken met paden en geven de namen terug in een beknopt formaat dat door alle PowerShell-providers kan worden geïnterpreteerd. Ze zijn ontworpen voor gebruik in programma's en scripts waarin u alle of een deel van een pad in een bepaalde indeling wilt weergeven. Gebruik ze zoals u Dirname, Normpath, Realpath, Joinof andere padmanipulatoren zou gebruiken.

De Test-Path is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.