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

Cmdleten Test-Path avgör om alla element i sökvägen finns. Den returnerar $true om alla element finns och $false om några saknas. Den kan också se om sökvägssyntaxen är giltig och om sökvägen leder till en container eller ett terminal- eller lövelement. Om Path är en blankstegssträng eller en tom sträng returnerar cmdleten $false. Om Path är $null, en matris med $null eller en tom matris returnerar cmdleten ett icke-avslutande fel.

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

True

Det här kommandot kontrollerar om alla element i sökvägen finns, inklusive katalogen C:, katalogen Documents and Settings och katalogen DavidC. Om några saknas returnerar cmdleten $false. Annars returneras $true.

Test-Path -Path $PROFILE

False

Test-Path -Path $PROFILE -IsValid

True

Dessa kommandon testar sökvägen till PowerShell-profilen.

Det första kommandot avgör om alla element i sökvägen finns. Det andra kommandot avgör om sökvägens syntax är korrekt. I det här fallet är sökvägen $false, men syntaxen är korrekt $true. Dessa kommandon använder $PROFILE, den automatiska variabeln som pekar på profilens plats, även om profilen inte finns.

Mer information om automatiska variabler finns i about_Automatic_Variables.

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

False

Det här kommandot kontrollerar om det finns några filer i katalogen Kommersiella byggnader förutom .dwg filer.

Kommandot använder parametern Path för att ange sökvägen. Eftersom sökvägen innehåller ett mellanslag, omsluts sökvägen av citattecken. Asterisken i slutet av sökvägen anger innehållet i katalogen Commercial Building. Med långa sökvägar, till exempel den här, skriver du de första bokstäverna i sökvägen och använder sedan TAB-nyckeln för att slutföra sökvägen.

Kommandot anger parametern Exclude för att ange filer som ska utelämnas från utvärderingen.

I det här fallet, eftersom katalogen endast innehåller .dwg filer, blir resultatet $false.

Test-Path -Path $PROFILE -PathType Leaf

True

Det här kommandot kontrollerar om sökvägen som lagras i variabeln $PROFILE leder till en fil. I det här fallet, eftersom PowerShell-profilen är en .ps1 fil, returnerar cmdleten $true.

Dessa kommandon använder Test-Path med PowerShell-registerprovidern.

Det första kommandot testar om registersökvägen för Microsoft.PowerShell registernyckel är korrekt i systemet. Om PowerShell är korrekt installerat returnerar cmdleten $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

Det här kommandot använder dynamiska parametrarna NewerThan och OlderThan för att avgöra om pwsh.exe filen på datorn är nyare än July 13, 2009 och äldre än förra veckan.

Parametrarna NewerThan och OlderThan fungerar bara på filsystemenheter.

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

True

Felet som returnerades för null, matris av null eller tom matris är ett ej avslutande fel. Det kan undertryckas med hjälp av -ErrorAction SilentlyContinue. I följande exempel visas alla fall som returnerar felet 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.TestPathCommand

När en blankstegssträng anges för parametern Path returneras $false. Det här är en ändring från Windows PowerShell 5.1. När en tom sträng anges returnerar Test-Path ett fel. I följande exempel visas blanksteg och tom sträng.

Test-Path ' '
Test-Path ''

False
False

När du testar en sökväg som innehåller en enhetsspecifikation misslyckas testningen av sökvägens giltighet om enheten inte finns. Du kan prefixa enheten med providernamnet för att kringgå det här problemet.

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

False
True

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller en sökväg, men inte en literal sökväg, till den här cmdleten.

Cmdleten returnerar ett booleskt värde.

Cmdlets som innehåller substantivet Path (Path cmdlets) används med sökvägar och returnerar sökvägsnamnen i ett kortfattat format som alla PowerShell-leverantörer kan tolka. De är utformade för användning i program och skript där du vill visa hela eller en del av en sökväg i ett visst format. Använd dem som du skulle använda Dirname, Normpath, Realpath, Joineller andra sökvägsmanipulatörer.

Test-Path är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.