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




Tabla de contenido