Obtiene el contenido del elemento en la ubicación especificada.
Sintaxis
Get-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>] Get-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-ReadCount <Int64>] [-TotalCount <Int64>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-Content obtiene el contenido del elemento en la ubicación especificada por la ruta de acceso, como el texto de un archivo. Lee el contenido línea a línea y devuelve un objeto por cada línea.
Parámetros
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Exclude <string[]>
Omite los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Filter <string>
Especifica un filtro en el formato o lenguaje 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 al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Pasa por alto las restricciones que impiden que el comando se ejecute correctamente, de tal modo que los cambios no pongan en peligro la seguridad. Por ejemplo, Force reemplazará el atributo de solo lectura o creará directorios para completar la ruta de acceso a un archivo, pero no intentará cambiar los permisos del archivo.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Recupera únicamente los elementos especificados. El valor de este parámetro califica el parámetro Path. Escriba un patrón o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica la ruta de acceso a un elemento. A diferencia de Path, el valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica la ruta de acceso a un elemento. Get-Content recupera el contenido del elemento. Se permite el uso de caracteres comodín. El nombre del parámetro ("Path" o "FilePath") es opcional.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-ReadCount <Int64>
Especifica cuántas líneas de contenido se envían simultáneamente a través de la canalización. El valor predeterminado es 1. Un valor 0 (cero) envía todo el contenido de una vez.
Este parámetro no cambia el contenido mostrado, pero afecta al tiempo que se tarda en mostrar el contenido. Como el valor de ReadCount aumenta, el tiempo que se tarda en devolver la primera línea aumenta, pero el tiempo total de la operación disminuye. Esto puede suponer una diferencia apreciable para elementos muy grandes.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-TotalCount <Int64>
Especifica cuántas líneas de contenido se recuperarán. El valor predeterminado es -1 (todas las líneas).
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No se puede canalizar la entrada a Get-Content. |
|
Salidas |
Object Get-Content devuelve objetos que representan el contenido que obtiene. El tipo de objeto depende del tipo de contenido. |
Notas
También puede hacer referencia a Get-Content mediante sus alias integrados, "cat", "type" y "gc". Para obtener más información, vea about_Aliases.
El cmdlet Get-Content está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PsProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>get-content -Path C:\Chapters\chapter1.txt Descripción ----------- Este comando muestra el contenido del archivo Chapter1.txt en la consola. Usa el parámetro Path para especificar el nombre del elemento. En realidad, Get-Content pasa el contenido a través de la canalización, pero como no hay otros elementos de canalización, se aplica formato al contenido en la consola y después se muestra.
Ejemplo 2
C:\PS>get-content c:\Logs\Log060912.txt -totalcount 50 | set-content sample.txt Descripción ----------- Este comando obtiene las primeras 50 líneas del archivo Log060912.txt y las almacena en el archivo sample.txt. El comando usa el cmdlet Get-Content para obtener el texto del archivo. (El nombre del parámetro Path, que es opcional, se omite). El parámetro TotalCount limita la recuperación a las 50 primeras líneas. El operador de canalización (|) envía el resultado a Set-Content, que lo coloca en el archivo sample.txt.
Ejemplo 3
C:\PS>(get-content cmdlets.txt -totalcount 5)[-1] Descripción ----------- Este comando obtiene la quinta línea del archivo de texto Cmdlets.txt. Utiliza el parámetro TotalCount para obtener las primeras cinco líneas y, a continuación, utiliza la notación de matriz para obtener la última línea (indicada por "-1") del conjunto resultante.
Vea también