Crea un registro de una parte o de la totalidad de una sesión de Windows PowerShell en un archivo de texto.
Sintaxis
Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Descripción
El cmdlet Start-Transcript crea un registro de una parte o de la totalidad de una sesión de Windows PowerShell en un archivo de texto. La transcripción incluye todos los comandos que escribe el usuario y todos los resultados que se muestran en la consola.
Parámetros
-Append
Agrega la nueva transcripción al final de un archivo existente. Use el parámetro Path para especificar el archivo.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Force
Permite al cmdlet anexar la transcripción a un archivo de solo lectura existente. Cuando se utiliza con un archivo de solo lectura, el cmdlet cambia el permiso del archivo a lectura y escritura. Incluso si se usa el parámetro Force, el cmdlet no puede invalidar las restricciones de seguridad.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-NoClobber
No sobrescribirá un archivo existente (es decir, no remplazará su contenido). De forma predeterminada, si existe un archivo de transcripción en la ruta de acceso especificada, Start-Transcript sobrescribirá el archivo sin avisar.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Path <string>
Especifica una ubicación para el archivo de transcripción. Escriba la ruta de acceso a un archivo .txt. No se permite el uso de caracteres comodín.
Si no indica una ruta de acceso, Start-Transcript usará la ruta de acceso establecida en el valor de la variable global $Transcript. Si no ha creado esta variable, Start-Transcript almacenará las transcripciones en el directorio $Home\Mis documentos como archivos \PowerShell_transcript.<marcaDeTiempo>.txt.
Si no existe alguno de los directorios en la ruta de acceso, se producirá un error al ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el comando.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-WhatIf
Describe lo que ocurriría si se ejecutara el comando, sin ejecutarlo realmente.
|
¿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 puede canalizar objetos a este cmdlet. |
|
Salidas |
System.String Start-Transcript devuelve una cadena que contiene un mensaje de confirmación y la ruta de acceso al archivo de salida. |
Notas
Para detener una transcripción, utilice el cmdlet Stop-Transcript.
Para registrar una sesión completa, agregue el comando Start-Transcript a su perfil. Para obtener más información, vea about_Profiles.
Ejemplo 1
C:\PS>start-transcript Descripción ----------- Este comando inicia una transcripción en la ubicación predeterminada del archivo.
Ejemplo 2
C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber Descripción ----------- Este comando inicia una transcripción en el archivo Transcript0.txt en C:\transcripts. El parámetro NoClobber impide que se sobrescriban archivos existentes. Si ya existe el archivo Transcript0.txt, se producirá un error al ejecutar el comando.
Vea también