about_FileSystem_Provider
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.
- Get-Location
- Set-Location
- Get-Item
- Get-ChildItem
- Invoke-Item
- Move-Item
- New-Item
- Remove-Item
- Get-ItemProperty
- Set-ItemProperty
- Clear-Item
- Clear-ItemProperty
- Remove-Item
- Remove-ItemProperty
- Get-Acl
- Set-Acl
- Get-AuthenticodeSignature
- Set-AuthenticodeSignature
- Add-Content
- Clear-Content
- Get-Content
- Set-Content
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
, Junction
y 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 ->
Navegación por las unidades FileSystem
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
Eliminar 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+Hidden
que 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 Compressed
Encrypted
. 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: