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

O Test-Path cmdlet determina se todos os elementos do caminho existem. Retorna $true se todos os elementos existirem e $false se algum estiver em falta. Também pode indicar se a sintaxe do caminho é válida e se o caminho conduz a um contentor, a um terminal ou elemento folha. Se o Path for um espaço em branco ou uma cadeia vazia, então o cmdlet devolve $false. Se o Path for $null, um array de $null ou um array vazio, o cmdlet devolve um erro que não termina.

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

True

Este comando verifica se todos os elementos do caminho existem, incluindo o C: diretório, o Documents and Settings diretório e o DavidC diretório. Se algum estiver em falta, o cmdlet devolve $false. Caso contrário, ele retorna $true.

Test-Path -Path $PROFILE

False

Test-Path -Path $PROFILE -IsValid

True

Estes comandos testam o percurso do perfil PowerShell.

O primeiro comando determina se todos os elementos do caminho existem. O segundo comando determina se a sintaxe do caminho está correta. Neste caso, o caminho é $false, mas a sintaxe está correta $true. Estes comandos usam $PROFILE, a variável automática que aponta para a localização do perfil, mesmo que o perfil não exista.

Para obter mais informações sobre variáveis automáticas, consulte about_Automatic_Variables.

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

False

Este comando verifica se existem ficheiros no diretório Edifícios Comerciais para além de .dwg ficheiros.

O comando usa o parâmetro Path para especificar o caminho. Como o caminho inclui um espaço, o caminho está incluído entre aspas. O asterisco no final do percurso indica o conteúdo do diretório de Edifícios Comerciais. Com caminhos longos, como este, escreve as primeiras letras do caminho e depois usa a tecla TAB para completar o caminho.

O comando especifica o parâmetro Exclude para especificar ficheiros a omitir da avaliação.

Neste caso, como o diretório contém apenas .dwg ficheiros, o resultado é $false.

Test-Path -Path $PROFILE -PathType Leaf

True

Este comando verifica se o caminho armazenado na $PROFILE variável conduz a um ficheiro. Neste caso, como o perfil PowerShell é um .ps1 ficheiro, o cmdlet devolve $true.

Estes comandos são usados Test-Path com o fornecedor do Registo PowerShell.

O primeiro comando testa se o caminho do registo do Microsoft. A chave de registo PowerShell está correta no sistema. Se o PowerShell estiver instalado corretamente, o cmdlet devolve $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

Este comando utiliza o parâmetro dinâmico NewerThan para determinar se o pwsh.exe ficheiro no computador é mais recente do que July 13, 2009.

O parâmetro NewerThan funciona apenas em discos de sistema de ficheiros.

Test-Path $PSHOME\pwsh.exe -NewerThan "July 13, 2009"

True

O erro devolvido para null, array de null ou array vazio é um erro não terminante. Pode ser suprimido usando -ErrorAction SilentlyContinue. O exemplo seguinte mostra todos os casos que devolvem o NullPathNotPermitted erro.

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

Quando uma cadeia de espaços em branco é fornecida para o parâmetro Path , ela retorna $false. Isto é uma alteração em relação ao PowerShell 5.1 do Windows. Quando uma cadeia vazia é fornecida, Test-Path devolve um erro. O exemplo seguinte mostra espaços em branco e cadeias vazias.

Test-Path ' '
Test-Path ''

False
False

Quando testas um caminho que inclui uma especificação do disco, testar a validade do caminho falha se o disco não existir. Pode prefixar o disco com o nome do fornecedor para contornar este problema.

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

False
True

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode canalizar uma cadeia de caracteres que contém um caminho, mas não um caminho literal, para esse cmdlet.

O cmdlet devolve um valor booleano .

Os cmdlets que contêm o substantivo Path (os cmdlets Path ) trabalham com path e devolvem os nomes num formato conciso que todos os fornecedores PowerShell podem interpretar. São concebidos para uso em programas e scripts onde se quer mostrar todo ou parte de um caminho num formato específico. Usa-os como usarias Dirname, Normpath, Realpath, Join ou outros manipuladores de caminhos.

É Test-Path concebido para trabalhar com os dados expostos por qualquer fornecedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.