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

El cmdlet Test-Path determina si existen todos los elementos de la ruta. Devuelve $True si todos los elementos existen y $False si falta alguno. También puede indicar si la sintaxis de la ruta de acceso es válida y si la ruta de acceso lleva a un contenedor o a un elemento de terminal u hoja. Si el Path es un espacio en blanco, se devuelve $False. Si el Path es una cadena vacía, $null, matriz de $null o matriz vacía, se devuelve un error de no terminación.

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

True

Este comando comprueba si existen todos los elementos de la ruta de acceso, es decir, el directorio C: , el directorio Documents and Settings y el directorio DavidC. Si falta alguno, el cmdlet devuelve $False. En caso contrario, devuelve $True.

Test-Path -Path $profile

False

Test-Path -Path $profile -IsValid

True

Estos comandos prueban la ruta de acceso del perfil de PowerShell.

El primer comando determina si existen todos los elementos de la ruta. El segundo comando determina si la sintaxis de la ruta de acceso es correcta. En este caso, la ruta de acceso es $False, pero la sintaxis es correcta $True. Estos comandos usan $profile, la variable automática que apunta a la ubicación del perfil, incluso si el perfil no existe.

Para obtener más información sobre las variables automáticas, consulte about_Automatic_Variables.

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

False

Este comando comprueba si hay archivos en el directorio Edificios comerciales distintos de .dwg archivos.

El comando usa el parámetro Path para especificar la ruta de acceso. Dado que la ruta de acceso incluye un espacio, se incluye entre comillas. El asterisco al final de la ruta de acceso indica el contenido del directorio Commercial Building. Con rutas de acceso largas, como esta, escriba las primeras letras de la ruta de acceso y, a continuación, use la tecla TAB para completar la ruta de acceso.

El comando especifica el parámetro Exclude para especificar los archivos que se omitirán de la evaluación.

En este caso, dado que el directorio solo contiene .dwg archivos, el resultado es $False.

Test-Path -Path $profile -PathType leaf

True

Este comando comprueba si la ruta de acceso almacenada en la variable $profile conduce a un archivo. En este caso, dado que el perfil de PowerShell es un archivo .ps1, el cmdlet devuelve $True.

Estos comandos usan Test-Path con el proveedor del registro de PowerShell.

El primer comando comprueba si la ruta de acceso del Registro de la clave del Registro de Microsoft.PowerShell es correcta en el sistema. Si PowerShell está instalado correctamente, el cmdlet devuelve $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 usa el parámetro dinámico NewerThan para determinar si el archivo "PowerShell.exe" en el equipo es más reciente que "13 de julio de 2009".

El parámetro NewerThan solo funciona en unidades del sistema de archivos.

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

True

El error devuelto para null, matriz de null o matriz vacía es un error no terminal. Puedes suprimirlo mediante -ErrorAction SilentlyContinue. En el ejemplo siguiente se muestran todos los casos que devuelven el error de 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

Cuando un espacio en blanco es o una cadena vacía proporcionada para el parámetro -Path, devuelve false. En el ejemplo siguiente se muestran espacios en blanco y cadenas vacías.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Puede pasar una cadena que contenga una ruta, pero no una ruta literal, a este cmdlet.

El cmdlet devuelve un valor booleano.

Los cmdlets que contienen el sustantivo Path (los cmdlets Path) trabajan con nombres de rutas y devuelven los nombres en un formato conciso que todos los proveedores de PowerShell pueden interpretar. Están diseñados para su uso en programas y scripts en los que desea mostrar todo o parte de un nombre de ruta de acceso en un formato determinado. Úselos como usaría Dirname, Normpath, Realpath, Join u otros manipuladores de ruta de acceso.

El Test-Path está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.