about_FileSystem_Provider

  • Artículo

Nombre del proveedor

FileSystem

Unidades

C:, , D:... Temp:

Funcionalidades

Filter, ShouldProcess

Descripción breve

Proporciona acceso a archivos y directorios.

Descripción detallada

El proveedor FileSystem de PowerShell le permite obtener, agregar, cambiar, borrar y eliminar archivos y directorios en PowerShell.

Las unidades FileSystem son un espacio de nombres jerárquico que contiene los directorios y archivos del equipo. Una unidad FileSystem puede ser una unidad lógica o física, un directorio o un recurso compartido de red asignado.

A partir de la versión 7.0 de PowerShell, una unidad denominada TEMP: se asigna a la ruta de acceso del directorio temporal del usuario. PowerShell usa el método GetTempPath() de .NET para determinar la ubicación de la carpeta temporal. En Windows, la ubicación es la misma que $env:TEMP. En sistemas que no son windows, la ubicación es la misma $env:TMPDIR que o /tmp si no se define la variable de entorno.

El proveedor FileSystem admite los siguientes cmdlets, que se tratan en este artículo.

Tipos expuestos por este proveedor

Los archivos son instancias de la clase System.IO.FileInfo . Los directorios son instancias de la clase System.IO.DirectoryInfo .

El sistema de tipos extendidos de PowerShell agrega propiedades adicionales a estos tipos de objetos para proporcionar información adicional. Cierta información es específica de la plataforma. Por ejemplo, los valores posibles de la propiedad LinkType dependen de la plataforma y del sistema de archivos que se usa. Los sistemas de archivos linux y macOS admiten HardLink y SymLink. Windows NTFS admite HardLink, SymLink, Junctiony otros valores para LinkType.

Cuando se usa Get-Item o Get-ChildItem para obtener información sobre un elemento vinculado, la propiedad Mode contiene un l para indicar que el elemento es un vínculo. La propiedad LinkType contiene el tipo de vínculo.

AppExecLink Los vínculos se crean al instalar una aplicación desde Microsoft Store. En AppExecLink el caso de los vínculos, Windows no proporciona valores para las propiedades LinkType o LinkTarget .

Get-Item ~\AppData\Local\Microsoft\WindowsApps\winget.exe

    Directory: C:\Users\user1\AppData\Local\Microsoft\WindowsApps

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
la---            6/8/2023 12:20 PM              0 winget.exe ->

El proveedor FileSystem expone sus almacenes de datos mediante la asignación de unidades lógicas en el equipo como unidades de PowerShell. Para trabajar con una unidad FileSystem , puede cambiar la ubicación a una unidad mediante el nombre de la unidad seguido de dos puntos (:).

Set-Location C:

También puede trabajar con el proveedor FileSystem desde cualquier otra unidad de PowerShell. Para hacer referencia a un archivo o directorio desde otra ubicación, use el nombre de unidad (C:, D:, ...) en la ruta de acceso.

Nota:

PowerShell usa alias para permitirle trabajar con rutas de acceso de proveedor. Los comandos como dir y ls ahora son alias para Get-ChildItem, cd es un alias para Set-Location. y pwd es un alias para Get-Location.

Obtención de archivos y directorios

El Get-ChildItem cmdlet devuelve todos los archivos y directorios de la ubicación actual. Puede especificar una ruta de acceso diferente para buscar y usar parámetros integrados para filtrar y controlar la profundidad de recursividad.

Get-ChildItem

Para más información sobre el uso de cmdlets, consulte Get-ChildItem.

Copiar archivos y directorios

El Copy-Item cmdlet copia archivos y directorios en una ubicación que especifique. Los parámetros están disponibles para filtrar y recurse, de forma similar a Get-ChildItem.

El comando siguiente copia todos los archivos y directorios en la ruta C:\temp\ de acceso a la carpeta C:\Windows\Temp.

Copy-Item -Path C:\temp\* -Destination C:\Windows\Temp -Recurse -File

Copy-Item sobrescribe los archivos en el directorio de destino sin pedir confirmación.

Este comando copia el a.txt archivo del C:\a directorio en el C:\a\bb directorio .

Copy-Item -Path C:\a\a.txt -Destination C:\a\bb\a.txt

Copia todos los directorios y archivos del C:\a directorio en el C:\c directorio. Si alguno de los directorios que se van a copiar ya existe en el directorio de destino, se produce un error en el comando a menos que especifique el parámetro Force .

Copy-Item -Path C:\a\* -Destination C:\c -Recurse

Para obtener más información, vea Copy-Item.

Mover archivos y directorios

Este comando mueve el c.txt archivo del C:\a directorio al C:\a\aa directorio :

Move-Item -Path C:\a\c.txt -Destination C:\a\aa

De forma predeterminada, el cmdlet no sobrescribe un archivo existente que tiene el mismo nombre. Para forzar que el cmdlet sobrescriba un archivo existente, especifique el parámetro Force .

No se puede mover un directorio cuando ese directorio es la ubicación actual. Cuando se usa Move-Item para mover el directorio en la ubicación actual, verá este error.

C:\temp> Move-Item -Path C:\temp\ -Destination C:\Windows\Temp

Move-Item : Cannot move item because the item at 'C:\temp\' is in use.
At line:1 char:1
+ Move-Item C:\temp\ C:\temp2\
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [Move-Item], PSInvalidOperationException
    + FullyQualifiedErrorId : InvalidOperation,Microsoft.PowerShell.Commands.MoveItemCommand

Administración del contenido del archivo

Obtener el contenido de un archivo

Este comando obtiene el contenido del archivo "Test.txt" y los muestra en la consola.

Get-Content -Path Test.txt

Puede canalizar el contenido del archivo a otro cmdlet. Por ejemplo, el siguiente comando lee el contenido del Test.txt archivo y, a continuación, los proporciona como entrada para el cmdlet ConvertTo-Html :

Get-Content -Path Test.txt | ConvertTo-Html

También puede recuperar el contenido de un archivo mediante el prefijo de su ruta de acceso del proveedor con el signo de dólar ($). La ruta de acceso debe incluirse entre llaves debido a restricciones de nomenclatura de variables. Para obtener más información, consulte about_Variables.

${C:\Windows\System32\Drivers\etc\hosts}

Agregar contenido a un archivo

Este comando anexa la cadena "test content" al Test.txt archivo :

Add-Content -Path test.txt -Value "test content"

El contenido existente en el Test.txt archivo no se elimina.

Reemplazar el contenido de un archivo

Este comando reemplaza el contenido del Test.txt archivo por la cadena "test content":

Set-Content -Path test.txt -Value "test content"

Sobrescribe el contenido de Test.txt. Puede usar el parámetro Value del New-Item cmdlet para agregar contenido a un archivo al crearlo.

Recorrer en bucle el contenido de un archivo

De forma predeterminada, el Get-Content cmdlet usa el carácter de final de línea como su delimitador, por lo que obtiene un archivo como una colección de cadenas, con cada línea como una cadena en el archivo.

Puede usar el parámetro Delimiter para especificar un delimitador alternativo. Si lo establece en los caracteres que indican el final de una sección o el principio de la sección siguiente, puede dividir el archivo en partes lógicas.

El primer comando obtiene el Employees.txt archivo y lo divide en secciones, cada uno de los cuales termina con las palabras "Fin del registro de empleado" y lo guarda en la $e variable .

El segundo comando usa la notación de matriz para obtener el primer elemento de la colección en $e. Usa un índice de 0, ya que las matrices de PowerShell están basadas en cero.

Para obtener más información sobre Get-Content el cmdlet, consulte el tema de ayuda de Get-Content.

Para obtener más información sobre las matrices, consulte about_Arrays.

$e = Get-Content c:\test\employees.txt -Delimited "End Of Employee Record"
$e[0]

Administración de descriptores de seguridad

Visualización de la ACL de un archivo

Este comando devuelve un objeto System.Security.AccessControl.FileSecurity :

Get-Acl -Path test.txt | Format-List -Property *

Para obtener más información sobre este objeto, canalice el comando al cmdlet Get-Member o vea la clase FileSecurity .

Creación de archivos y directorios

Creación de un directorio

Este comando crea el logfiles directorio en la C unidad:

New-Item -Path c:\ -Name logfiles -Type directory

PowerShell también incluye una mkdir función (alias md) que usa el New-Item cmdlet para crear un nuevo directorio.

Creación de un archivo

Este comando crea el log2.txt archivo en el C:\logfiles directorio y, a continuación, agrega la cadena "registro de pruebas" al archivo:

New-Item -Path c:\logfiles -Name log2.txt -Type file

Creación de un archivo con contenido

Crea un archivo llamado log2.txt en el C:\logfiles directorio y agrega la cadena "registro de prueba" al archivo.

New-Item -Path c:\logfiles -Name log2.txt -Type file -Value "test log"

Cambiar el nombre de archivos y directorios

Cambio del nombre de un archivo

Este comando cambia el nombre del a.txt archivo del C:\a directorio a b.txt:

Rename-Item -Path c:\a\a.txt -NewName b.txt

Cambiar el nombre de un directorio

Este comando cambia el nombre del C:\a\cc directorio a C:\a\dd:

Rename-Item -Path c:\a\cc -NewName dd

Eliminación de archivos y directorios

Eliminar un archivo

Este comando elimina el Test.txt archivo en el directorio actual:

Remove-Item -Path test.txt

Eliminación de archivos mediante caracteres comodín

Este comando elimina todos los archivos del directorio actual que tienen la extensión de .xml nombre de archivo:

Remove-Item -Path *.xml

Iniciar un programa invocando un archivo asociado

Invocación de un archivo

El cmdlet Get-Service para obtener información sobre los servicios locales y canaliza la información al cmdlet Export-Csv para almacenar la información en el Services.csv archivo.

A continuación , Invoke-Item abre el services.csv archivo en el programa asociado con la .csv extensión :

Get-Service | Export-Csv -Path services.csv
Invoke-Item -Path services.csv

Obtención de archivos y carpetas con atributos especificados

Obtener archivos del sistema

Este comando obtiene los archivos del sistema que se encuentren en el directorio actual y en sus subdirectorios.

Usa el parámetro File para obtener solo archivos (no directorios) y el parámetro System para obtener solo elementos con el atributo "system".

Usa el parámetro Recurse para obtener los elementos del directorio actual y todos los subdirectorios.

Get-ChildItem -File -System -Recurse

Obtener archivos ocultos

Este comando obtiene todos los archivos, incluidos los ocultos, que se encuentren en el directorio actual.

Usa el parámetro Attributes con dos valores, , !Directory+Hiddenque obtiene archivos ocultos y !Directory, que obtiene todos los demás archivos.

Get-ChildItem -Attributes !Directory,!Directory+Hidden

dir -att !d,!d+h es el equivalente de este comando.

Obtener archivos comprimidos y cifrados

Este comando obtiene los archivos del directorio actual que estén comprimidos o cifrados.

Usa el parámetro Attributes con dos valores y CompressedEncrypted. Los valores están separados por una coma , que representa el operador "OR".

Get-ChildItem -Attributes Compressed,Encrypted

Parámetros dinámicos

Los parámetros dinámicos son parámetros de cmdlet que agrega un proveedor de PowerShell y solo están disponibles cuando el cmdlet se usa en la unidad habilitada para el proveedor.

Codificación <de codificación>

Especifica la codificación del archivo. El valor predeterminado es ASCII.

  • ascii: usa la codificación para el juego de caracteres ASCII (7 bits).
  • bigendianunicode: codifica en formato UTF-16 mediante el orden de bytes big-endian.
  • bigendianutf32: codifica en formato UTF-32 mediante el orden de bytes big-endian.
  • oem: usa la codificación predeterminada para los programas de consola y MS-DOS.
  • unicode: codifica en formato UTF-16 mediante el orden de bytes little-endian.
  • utf7: codifica en formato UTF-7.
  • utf8: codifica en formato UTF-8.
  • utf8BOM: codifica en formato UTF-8 con marca de orden de bytes (BOM)
  • utf8NoBOM: codifica en formato UTF-8 sin marca de orden de bytes (BOM)
  • utf32: codifica en formato UTF-32.

Cmdlets admitidos

  • Add-Content
  • Get-Content
  • Set-Content

Cadena delimitador <>

Especifica el delimitador que Get-Content usa para dividir el archivo en objetos mientras lee.

El valor predeterminado es \n, el carácter de final de línea.

Al leer un archivo de texto, Get-Content devuelve una colección de objetos de cadena, cada uno de los cuales termina con el carácter delimitador.

Al escribir un delimitador que no existe en el archivo, Get-Content se devuelve todo el archivo como un único objeto delimitado sin delimitar.

Puede utilizar este parámetro para dividir un archivo grande en archivos más pequeños. Para ello, especifique un separador de archivo como delimitador, como por ejemplo, "Fin del ejemplo". El delimitador se conserva (no se descarta) y se convierte en el último elemento de cada sección de archivo.

Nota:

Actualmente, cuando el valor del parámetro Delimiter es una cadena vacía, Get-Content no devuelve nada. Este es un problema conocido. Para forzar Get-Content que devuelva todo el archivo como una sola cadena sinlimitar, escriba un valor que no exista en el archivo.

Cmdlets admitidos

  • Get-Content

Wait <SwitchParameter>

Espera a que el contenido se anexe al archivo. Si se anexa el contenido, devuelve el contenido anexado. Si el contenido ha cambiado, devuelve todo el archivo.

Al esperar, Get-Content comprueba el archivo una vez cada segundo hasta que se interrumpa, por ejemplo presionando CTRL+C.

Cmdlets admitidos

  • Get-Content

Marcas de atributosExpression <>

Obtiene los archivos y las carpetas con los atributos especificados. Este parámetro es compatible con todos los atributos y permite especificar combinaciones complejas de atributos.

El parámetro Attributes se introdujo en Windows PowerShell 3.0.

El parámetro Attributes admite los siguientes atributos:

  • Archivar
  • Compressed
  • Device
  • Directorio
  • Cifrado
  • Oculto
  • Normal
  • NotContentIndexed
  • Offline
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • Sistema
  • Temporal

Para obtener una descripción de estos atributos, consulte la enumeración FileAttributes .

Utilice los siguientes operadores para combinar atributos.

  • ! -NO
  • + -Y
  • , -O

No se permiten espacios entre un operador y su atributo. Sin embargo, se permiten espacios antes de comas.

Cmdlets admitidos

  • Get-ChildItem

SwitchParameter de directorio <>

Obtiene directorios (carpetas).

El parámetro Directory se introdujo en Windows PowerShell 3.0.

Para obtener solo directorios, use el parámetro Directory y omita el parámetro File . Para excluir directorios, use el parámetro File y omita el parámetro Directory o use el parámetro Attributes .

Cmdlets admitidos

  • Get-ChildItem

Modificador de archivoParameter <>

Obtiene archivos.

El parámetro File se introdujo en Windows PowerShell 3.0.

Para obtener solo los archivos, use el parámetro File y omita el parámetro Directory . Para excluir archivos, use el parámetro Directory y omita el parámetro File o use el parámetro Attributes .

Cmdlets admitidos

  • Get-ChildItem

SwitchParameter oculto <>

Obtiene solo los archivos y directorios ocultos (carpetas). De forma predeterminada, Get-ChildItem obtiene solo elementos no ocultos.

El parámetro Hidden se introdujo en Windows PowerShell 3.0.

Para obtener solo elementos ocultos, use el parámetro Hidden, sus h alias o ah o el valor Hidden del parámetro Attributes. Para excluir elementos ocultos, omita el parámetro Hidden o use el parámetro Attributes .

Cmdlets admitidos

  • Get-ChildItem

ReadOnly <SwitchParameter>

Obtiene únicamente archivos y directorios (carpetas) de solo lectura.

El parámetro ReadOnly se introdujo en Windows PowerShell 3.0.

Para obtener solo elementos de solo lectura, use el parámetro ReadOnly , su ar alias o el valor ReadOnly del parámetro Attributes . Para excluir elementos de solo lectura, use el parámetro Attributes .

Cmdlets admitidos

  • Get-ChildItem

Conmutador del sistemaParameter <>

Obtiene solo los archivos y directorios del sistema (carpetas).

El parámetro System se introdujo en Windows PowerShell 3.0.

Para obtener solo archivos y carpetas del sistema, use el parámetro System, su as alias o el valor System del parámetro Attributes. Para excluir archivos y carpetas del sistema, use el parámetro Attributes .

Cmdlets admitidos

  • Get-ChildItem

Más recienteThan <DateTime>

Devuelve $True cuando el LastWriteTime valor de un archivo es mayor que la fecha especificada. De lo contrario, devuelve $False.

Escriba un objeto DateTime , como el que devuelve el cmdlet Get-Date , o una cadena que se pueda convertir en un objeto DateTime , como "August 10, 2011 2:00 PM".

Cmdlets admitidos

OlderThan <DateTime>

Devuelve $True cuando el LastWriteTime valor de un archivo es menor que la fecha especificada. De lo contrario, devuelve $False.

Escriba un objeto DateTime , como el que devuelve el Get-Date cmdlet, o una cadena que se pueda convertir en un objeto DateTime , como "August 10, 2011 2:00 PM".

Cmdlets admitidos

  • Test-Path

Cadena de secuencia <>

Administra secuencias de datos alternativas. Escriba el nombre de la secuencia. Los caracteres comodín solo se permiten en Get-Item para los comandos y Remove-Item en una unidad del sistema de archivos.

Cmdlets admitidos

  • Add-Content
  • Clear-Content
  • Get-Item
  • Get-Content
  • Remove-Item
  • Set-Content

SwitchParameter sin formato <>

Omite los caracteres de nueva línea. Devuelve el contenido como un solo elemento.

Cmdlets admitidos

  • Get-Content

ItemType <String>

Este parámetro permite especificar el tipo de elemento que se va a crear con New-Item.

Los valores disponibles de este parámetro dependen del proveedor actual que use.

En una FileSystem unidad, se permiten los siguientes valores:

  • Archivo
  • Directorio
  • SymbolicLink
  • unión
  • HardLink

Cmdlets admitidos

  • New-Item

Uso de la canalización

Los cmdlets del proveedor aceptan entradas de canalización. Puede usar la canalización para simplificar la tarea mediante el envío de datos del proveedor de un cmdlet a otro cmdlet de proveedor. Para más información sobre cómo usar la canalización con cmdlets de proveedor, consulte las referencias de cmdlet proporcionadas en este artículo.

Ayuda

A partir de Windows PowerShell 3.0, puede obtener temas de ayuda personalizados sobre cmdlets de proveedor que explican cómo se comportan dichos cmdlets en una unidad del sistema de archivos.

Para obtener los temas de ayuda personalizados para la unidad del sistema de archivos, ejecute un comando Get-Help en una unidad del sistema de archivos o use el parámetro Path de para especificar una unidad del Get-Help sistema de archivos.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path c:

Consulte también