Test-Path

Módulo:

Microsoft.PowerShell.Management Module

Determina si existen todos los elementos de una ruta de acceso.

Sintaxis

Path (Default) - FileSystem provider

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

LiteralPath - FileSystem provider

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

Path (Default) - All providers

Test-Path
    [-Path] <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

LiteralPath - All providers

Test-Path
    -LiteralPath <string[]>
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-PathType <TestPathType>]
    [-IsValid]
    [-Credential <pscredential>]
    [<CommonParameters>]

Description

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 camino es un espacio en blanco o una cadena vacía, el cmdlet devuelve $false. Si la ruta de acceso es $null, una matriz de $null o una matriz vacía, el cmdlet genera un error recuperable.

Ejemplos

Ejemplo 1: Probar una ruta de acceso

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

True

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

Ejemplo 2: Probar la ruta de acceso de un perfil

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, vea about_Automatic_Variables.

Ejemplo 3: Comprobar si hay archivos además de un tipo especificado

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.

Ejemplo 4: Comprobación de un archivo

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.

Ejemplo 5: Comprobación de rutas de acceso en el Registro

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.

Importante

Test-Path no funciona correctamente con todos los proveedores de PowerShell. Por ejemplo, puede usar Test-Path para probar la ruta de acceso de una clave del Registro, pero si lo usa para probar la ruta de acceso de una entrada del Registro, siempre devuelve $false, incluso si la entrada del Registro está presente.

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

Ejemplo 6: Prueba si un archivo está en un intervalo de fechas

Este comando usa los parámetros dinámicos NewerThan y OlderThan para determinar si el archivo pwsh.exe del equipo es más reciente que July 13, 2009 y anterior a la semana pasada.

Los parámetros NewerThan y OlderThan solo funcionan en unidades del sistema de archivos.

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

True

Ejemplo 7: Probar una ruta de acceso con null como valor

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

Ejemplo 8: Prueba de una ruta de acceso con espacios en blanco como valor

Cuando se proporciona una cadena de espacio en blanco para el parámetro Path, devuelve $false. Este es un cambio de Windows PowerShell 5.1. Cuando se proporciona una cadena vacía, Test-Path devuelve un error. En el ejemplo siguiente se muestran los espacios en blanco y la cadena vacía.

Test-Path ' '
Test-Path ''

False
False

Ejemplo 9: Probar una ruta de acceso que puede tener una unidad no válida

Al probar una ruta de acceso que incluye una especificación de unidad, se produce un error al probar la validez de la ruta de acceso si la unidad no existe. Puede prefijar la unidad con el nombre del proveedor para solucionar este problema.

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

False
True

Parámetros

-Credential

Nota:

Este parámetro no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Propiedades del parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Exclude

Especifica los elementos que este cmdlet omite. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Filter

Especifica un filtro en el formato o idioma del proveedor. El valor de este parámetro define el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando recupera los objetos en lugar de que PowerShell filtre los objetos después de recuperarlos.

Propiedades del parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Include

Especifica las rutas de acceso que prueba este cmdlet. El valor de este parámetro define el parámetro Path. Escriba un elemento de ruta o patrón, como *.txt. Se permite el uso de caracteres comodín.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-IsValid

Indica que este cmdlet prueba la sintaxis de la ruta, independientemente de si existen los elementos de la ruta. Este cmdlet devuelve $true si la sintaxis de la ruta de acceso es válida y $false si no es así. Si la ruta de acceso que se prueba incluye una especificación de unidad de disco, el cmdlet devuelve "false" cuando la unidad de disco no existe. PowerShell devuelve false porque no sabe qué proveedor de unidad probar.

Nota:

Se introdujo un cambio disruptivo en las API de ruta en .NET 2.1. Esos métodos ya no comprueban si hay caracteres de ruta de acceso no válidos. Este cambio provocó una regresión en PowerShell, donde la comprobación IsValid ya no verifica caracteres no válidos. La regresión se abordará en una versión futura. Para obtener más información, consulte Cambios importantes en .NET Core 2.1.

Propiedades del parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-LiteralPath

Especifica la ruta de acceso que se va a probar. A diferencia de path, el valor del parámetro LiteralPath se usa exactamente como se escribe. Ningún carácter se interpreta como carácter comodín. Si la ruta de acceso incluye caracteres que PowerShell podría interpretar como secuencias de escape, debe incluir la ruta de acceso entre comillas simples para que no se interpreten.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	PSPath, LP

Conjuntos de parámetros

LiteralPath

Posición:	Named
Mandatory:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-NewerThan

Se trata de un parámetro dinámico que ofrece el proveedor de sistema de archivos .

Especifique una hora como un objeto del tipo DateTime .

Antes de PowerShell 7.5, el cmdlet omite:

• Este parámetro se utiliza cuando se especifica PathType como cualquier valor distinto de Any.
• El parámetro OlderThan cuando se usa con este parámetro.
• Este parámetro cuando Path apunta a un directorio.

A partir de PowerShell 7.5, puede usar este parámetro con cualquier valor para el parámetro PathType, para probar un intervalo de fechas con el parámetro OlderThan y para probar la antigüedad de los directorios.

Para obtener más información, vea about_FileSystem_Provider.

Propiedades del parámetro

Tipo:	Nullable<T>[[DateTime]]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-OlderThan

Se trata de un parámetro dinámico que ofrece el proveedor de sistema de archivos .

Especifique una hora como un objeto del tipo DateTime .

Antes de PowerShell 7.5, el cmdlet omite:

• Este parámetro se utiliza cuando se especifica PathType como cualquier valor distinto de Any.
• Este parámetro se usa cuando está acompañado del parámetro NewerThan.
• Este parámetro cuando Path apunta a un directorio.

A partir de PowerShell 7.5, puede usar este parámetro con cualquier valor para el parámetro PathType, para probar un intervalo de fechas con el parámetro NewerThan y para probar la antigüedad de los directorios.

Para obtener más información, vea about_FileSystem_Provider.

Propiedades del parámetro

Tipo:	Nullable<T>[[DateTime]]
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Path

Especifica la ruta de acceso que se va a probar. Se permite el uso de caracteres comodín. Si la ruta de acceso incluye espacios, escríbalo entre comillas.

Propiedades del parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

Path

Posición:	0
Mandatory:	True
Valor de la canalización:	True
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-PathType

Especifica el tipo del elemento final en la ruta. Este cmdlet devuelve $true si el elemento es del tipo especificado y $false si no lo es. Los valores aceptables para este parámetro son:

• Container: un elemento que contiene otros elementos, como un directorio o una clave del Registro.
• Leaf: un elemento que no contiene otros elementos, como un archivo.
• Any: un contenedor o una hoja.

Indica si el elemento final de la ruta de acceso es de un tipo determinado.

Precaución

Hasta la versión 6.1.2 de PowerShell, cuando el conmutador IsValid y el conmutador PathType se especifican juntos, el cmdlet Test-Path omite el conmutador PathType y valida únicamente la ruta sintáctica sin validar el tipo de ruta.

Según problema n.º 8607, corregir este comportamiento puede ser un cambio importante en una versión futura, donde el IsValid y los modificadores PathType pertenecen a conjuntos de parámetros independientes y, por lo tanto, no se pueden usar conjuntamente evitando esta confusión.

Propiedades del parámetro

Tipo:	TestPathType
Valor predeterminado:	None
Valores aceptados:	Any, Container, Leaf
Admite caracteres comodín:	False
DontShow:	False
Alias:	Tipo

Conjuntos de parámetros

(All)

Posición:	Named
Mandatory:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

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.

Entradas

String

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

Salidas

Boolean

El cmdlet devuelve un valor booleano.

Notas

Los cmdlets que contienen la palabra Path (los cmdlets de ruta de acceso) funcionan con la ruta de acceso y devuelven nombres en un formato conciso que todos los proveedores de Windows PowerShell pueden interpretar. Están diseñados para su uso en programas y scripts en los que desea mostrar toda o parte de una 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.

Vínculos relacionados

• Convert-Path
• Join-Path
• Resolve-Path
• Split-Path