Test-Path

Test-Path
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-OlderThan <DateTime>]
    [-NewerThan <DateTime>]
    [<CommonParameters>]

Test-Path コマンドレットは、パスのすべての要素が存在するかどうかを判断します。 すべての要素が存在する場合は $True を返し、存在しない場合は $False します。 また、パス構文が有効かどうか、およびパスがコンテナーまたはターミナル要素またはリーフ要素につながるかどうかを判断することもできます。 Path が空白の場合は、$False が返されます。 Path が空の文字列、$null、$null の配列、または空の配列である場合は、終了しないエラーが返されます。

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

True

このコマンドは、パス内のすべての要素 (C: ディレクトリ、Documents and Settings ディレクトリ、DavidC ディレクトリ) が存在するかどうかを確認します。 存在しない場合、コマンドレットは $Falseを返します。 それ以外の場合は、$Trueを返します。

Test-Path -Path $profile

False

Test-Path -Path $profile -IsValid

True

これらのコマンドは、PowerShell プロファイルのパスをテストします。

最初のコマンドは、パス内のすべての要素が存在するかどうかを決定します。 2 番目のコマンドは、パスの構文が正しいかどうかを判断します。 この場合、パスは $Falseですが、構文は正しい $Trueです。 これらのコマンドでは、プロファイルが存在しない場合でも、プロファイルの場所を指す自動変数である $profileを使用します。

自動変数の詳細については、about_Automatic_Variablesを参照してください。

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

False

このコマンドは、.dwg ファイル以外の Commercial Buildings ディレクトリにファイルがあるかどうかを確認します。

このコマンドでは、Path パラメーターを使用してパスを指定します。 パスにはスペースが含まれているため、パスは引用符で囲まれます。 パスの末尾にあるアスタリスクは、商業ビル ディレクトリの内容を示します。 このような長いパスでは、パスの最初の数文字を入力し、TAB キーを使用してパスを完了します。

このコマンドは、Exclude パラメーターを指定して、評価から省略するファイルを指定します。

この場合、ディレクトリには.dwgファイルのみが含まれているため、結果は $False。

Test-Path -Path $profile -PathType leaf

True

このコマンドは、$profile 変数に格納されているパスがファイルにつながるかどうかを確認します。 この場合、PowerShell プロファイルは .ps1 ファイルであるため、コマンドレットは $Trueを返します。

これらのコマンドは、PowerShell レジストリ プロバイダーで Test-Path を使用します。

最初のコマンドは、Microsoft.PowerShell レジストリ キーのレジストリ パスがシステム上で正しいかどうかをテストします。 PowerShell が正しくインストールされている場合、コマンドレットは $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

このコマンドは、NewerThan 動的パラメーターを使用して、コンピューター上の "PowerShell.exe" ファイルが "2009 年 7 月 13 日" より新しいかどうかを判断します。

NewerThan パラメーターは、ファイル システム ドライブでのみ機能します。

Test-Path $pshome\PowerShell.exe -NewerThan "July 13, 2009"

True

null、null の配列、または空の配列に対して返されるエラーは、終了しないエラーです。 -ErrorAction SilentlyContinueを使用して抑制できます。 次の例は、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

-Path パラメーターに空白文字が指定されている場合、または空の文字列が指定されている場合、false が返されます。 次の例は、空白と空の文字列を示しています。

Test-Path ' '
Test-Path ''

False
Test-Path : Cannot bind argument to parameter 'Path' because it is an empty string.
At line:1 char:11
+ Test-Path ''
+           ~~
    + CategoryInfo          : InvalidData: (:) [Test-Path], ParameterBindingValidationException
    + FullyQualifiedErrorId : ParameterArgumentValidationErrorEmptyStringNotAllowed,Microsoft.PowerShell.Commands.TestPathCommand

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

文字列に含まれるパスは、このコマンドレットにパイプできますが、リテラル パスはパイプできません。

このコマンドレットは、ブール値 を返します。

Path 名詞 (Path コマンドレット) を含むコマンドレットは、パス名を操作し、すべての PowerShell プロバイダーが解釈できる簡潔な形式で名前を返します。 これらは、パス名のすべてまたは一部を特定の形式で表示するプログラムやスクリプトで使用するように設計されています。 Dirname 、Normpath、Realpath、Join、またはその他のパス マニピュレータを使用する場合と同様に使用します。

Test-Path は、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用可能なプロバイダーを一覧表示するには、「Get-PSProvider」と入力します。 詳細については、about_Providersを参照してください。