Start-Transcript

Start-Transcript
    [[-Path] <String>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-IncludeInvocationHeader]
    [-UseMinimalHeader]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Start-Transcript
    [[-LiteralPath] <String>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-IncludeInvocationHeader]
    [-UseMinimalHeader]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Start-Transcript
    [[-OutputDirectory] <String>]
    [-Append]
    [-Force]
    [-NoClobber]
    [-IncludeInvocationHeader]
    [-UseMinimalHeader]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet Start-Transcript crea un registro de toda o parte de una sesión de PowerShell en un archivo de texto. La transcripción incluye todos los comandos que el usuario escribe y toda la salida que aparece en la consola.

De forma predeterminada, Start-Transcript almacena la transcripción en la siguiente ubicación con el nombre predeterminado:

• En Windows: $HOME\Documents
• En Linux o macOS: $HOME

El nombre de archivo predeterminado es PowerShell_transcript.<computername>.<random>.<timestamp>.txt.

A partir de Windows PowerShell 5.0, Start-Transcript incluye el nombre de host en el nombre de archivo generado de todas las transcripciones. El nombre de archivo también incluye caracteres aleatorios en nombres para evitar posibles sobrescrituras o duplicaciones al iniciar dos o más transcripciones simultáneamente. Incluir el nombre del equipo es útil si almacena las transcripciones en una ubicación centralizada. La cadena de caracteres aleatorios impide adivinar el nombre de archivo para obtener acceso no autorizado al archivo.

Si el archivo de destino no tiene una marca de orden de bytes (BOM), Start-Transcript el valor predeterminado es Utf8NoBom codificación en el archivo de destino.

Start-Transcript

Este comando inicia una transcripción en la ubicación de archivo predeterminada.

Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber

Este comando inicia una transcripción en el archivo Transcript0.txt en C:\transcripts. parámetro noClobber impide que se sobrescriban los archivos existentes. Si el archivo Transcript0.txt ya existe, se produce un error en el comando.

En el ejemplo siguiente se crea un archivo de transcripción con un nombre lo suficientemente único como para almacenarse en una ubicación compartida. El nombre de archivo se construye a partir del nombre del usuario, el nombre de host del equipo que ejecuta PowerShell, la versión de PowerShell y la fecha y hora. La transcripción se almacena en el recurso compartido de archivos \\Server01\Transcripts.

$sharePath  = '\\Server01\Transcripts'
$username   = $Env:USERNAME
$hostname   = hostname
$version    = $PSVersionTable.PSVersion.ToString()
$datetime   = Get-Date -F 'yyyyMMddHHmmss'
$filename   = "Transcript-${username}-${hostname}-${version}-${datetime}.txt"
$Transcript = (Join-Path -Path $sharePath -ChildPath $filename).ToString()
Start-Transcript

La ruta de acceso completa al archivo de transcripción se almacena en la variable de preferencia $Transcript. Para obtener más información sobre la variable de preferencia de $Transcript, consulte about_Preference_Variables.

Cuando se usa una ruta de acceso relativa con el parámetro OutputDirectory en Windows, la ruta de acceso es relativa al Documents directorio.

Start-Transcript -Path .\transcripts

Transcript started, output file is C:\Users\username\Documents\.\transcripts\PowerShell_transcript.HOSTNAME.8S6RpEfN.20251105152247.txt

Cuando se usa una ruta de acceso relativa con el parámetro OutputDirectory en sistemas que no son windows, la ruta de acceso es relativa al directorio principal.

Start-Transcript -Path ./transcripts

Transcript started, output file is /home/username/./transcripts/PowerShell_transcript.hostname.ift21QeV.20251105151236.txt

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

No se pueden canalizar objetos a este cmdlet.

Este cmdlet devuelve una cadena que contiene un mensaje de confirmación y la ruta de acceso al archivo de salida.

Para detener una transcripción, use el cmdlet Stop-Transcript.

Para grabar una sesión completa, agregue el comando Start-Transcript al perfil. Para obtener más información, vea about_Profiles.