Test-Path

Referencia

Módulo:: Microsoft.PowerShell.Management

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

Sintaxis

PowerShell

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

PowerShell

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

PowerShell

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

PowerShell

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 de acceso. 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 conduce a un contenedor o a un terminal o elemento hoja. Si el Ruta de acceso es un espacio en blanco o una cadena vacía, el cmdlet devuelve $false. Si el ruta de acceso es $null, una matriz de $null o una matriz vacía, el cmdlet devuelve un error de no terminación.

Ejemplos

Ejemplo 1: Probar una ruta de acceso

PowerShell

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. De lo contrario, devuelve $true.

Ejemplo 2: Probar la ruta de acceso de un perfil

PowerShell

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 de acceso. 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

PowerShell

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, la ruta de acceso se incluye entre comillas. El asterisco al final de la ruta de acceso indica el contenido del directorio Edificio comercial. 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

PowerShell

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 Microsoft.PowerShell clave del Registro 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.

PowerShell

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.

PowerShell

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 de no terminación. Se puede suprimir mediante -ErrorAction SilentlyContinue. En el ejemplo siguiente se muestran todos los casos que devuelven el error de NullPathNotPermitted.

PowerShell

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 de, 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.

PowerShell

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.

PowerShell

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.

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Exclude

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

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-Filter

Especifica un filtro en el formato o idioma del proveedor. El valor de este parámetro califica 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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-Include

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

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	True

-IsValid

Indica que este cmdlet prueba la sintaxis de la ruta de acceso, independientemente de si existen los elementos de la ruta de acceso. 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, el cmdlet devuelve false cuando la unidad no existe. PowerShell devuelve false porque no sabe qué proveedor de versiones se va a probar.

Nota

Se introdujo un cambio importante en las API de ruta de acceso 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 el IsValid comprobación ya no comprueba si hay 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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-LiteralPath

Especifica una ruta de acceso que se va a probar. A diferencia de path, el valor del parámetro LiteralPath se usa exactamente como se escribe. No se interpreta ningún 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.

Tipo:	String[]
Alias:	PSPath, LP
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-NewerThan

Se trata de un parámetro dinámico que el proveedor fileSystem de.

Especifique una hora como un objeto DateTime.

Antes de PowerShell 7.5, el cmdlet omite:

Este parámetro al especificar PathType como cualquier valor distinto de Any.
El parámetro OlderThan cuando se usa con este parámetro.
Este parámetro cuando Ruta de acceso 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.

Tipo:	Nullable<T>[[DateTime]]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OlderThan

Se trata de un parámetro dinámico que el proveedor fileSystem de.

Especifique una hora como un objeto DateTime.

Antes de PowerShell 7.5, el cmdlet omite:

Este parámetro al especificar PathType como cualquier valor distinto de Any.
Este parámetro se usa con el parámetro NewerThan.
Este parámetro cuando Ruta de acceso 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.

Tipo:	Nullable<T>[[DateTime]]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path

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

Tipo:	String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	True

-PathType

Especifica el tipo del elemento final en la ruta de acceso. 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 IsValid y modificadores PathType se especifican juntos, el cmdlet Test-Path omite el modificador PathType y solo valida la ruta de acceso sintáctica sin validar el tipo de ruta de acceso.

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.

Tipo:	TestPathType
Alias:	Type
Valores aceptados:	Any, Container, Leaf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso, pero no una ruta de acceso literal, a este cmdlet.

Salidas

Boolean

El cmdlet devuelve un valor de booleano.

Notas

Los cmdlets que contienen la ruta de acceso nombre (los cmdlets de ruta de acceso de) funcionan con la ruta de acceso 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 toda o parte de una ruta de acceso en un formato determinado. Úselos como usaría Dirname, Normpath, Realpath, Joinu otros manipuladores de rutas 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, vea about_Providers.

Compartir a través de

Test-Path

Sintaxis

Description

Ejemplos

Ejemplo 1: Probar una ruta de acceso

Ejemplo 2: Probar la ruta de acceso de un perfil

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

Ejemplo 4: Comprobación de un archivo

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

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

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

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

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

Parámetros

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

Entradas

Salidas

Notas

Recursos adicionales

Compartir a través de

Test-Path

Sintaxis

Description

Ejemplos

Ejemplo 1: Probar una ruta de acceso

Ejemplo 2: Probar la ruta de acceso de un perfil

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

Ejemplo 4: Comprobación de un archivo

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

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

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

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

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

Parámetros

-Credential

-Exclude

-Filter

-Include

-IsValid

-LiteralPath

-NewerThan

-OlderThan

-Path

-PathType

Entradas

Salidas

Notas

Vínculos relacionados

Recursos adicionales