Start-Transcript
Crea un registro de toda o parte de una sesión de PowerShell en un archivo de texto.
Syntax
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>]
Description
El Start-Transcript
cmdlet crea un registro de toda o parte de una sesión de PowerShell en un archivo de texto. Esta transcripción incluye todos los comandos que el usuario escribe y todos los resultados que aparecen en la consola.
De forma predeterminada, Start-Transcript
almacena la transcripción en la siguiente ubicación con el nombre predeterminado:
- En la ventana:
$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 cuando se inician 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
codificar en el archivo de destino.
Ejemplos
Ejemplo 1: Iniciar un archivo de transcripción con la configuración predeterminada
Start-Transcript
Este comando inicia una transcripción en la ubicación predeterminada del archivo.
Ejemplo 2: Iniciar un archivo de transcripción en una ubicación específica
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber
Este comando inicia una transcripción en el Transcript0.txt
archivo de C:\transcripts
. Dado que se usa el parámetro NoClobber , el comando impide que se sobrescriban los archivos existentes. Si el Transcript0.txt
archivo ya existe, se produce un error en el comando.
Ejemplo 3: Iniciar un archivo de transcripción con un nombre único y almacenarlo en un recurso compartido de archivos
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 \\Server01\Transcripts
archivos.
$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
Start-Transcript
La ruta de acceso completa al archivo de transcripción se almacena en la variable de $Transcript
preferencia. Para obtener más información sobre la $Transcript
variable de preferencia, consulte about_Preference_Variables.
Parámetros
-Append
Indica que este cmdlet agrega la nueva transcripción al final de un archivo existente. Use el parámetro Path para especificar el archivo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Permite al cmdlet anexar la transcripción a un archivo de solo lectura existente. Cuando se usa en un archivo de solo lectura, el cmdlet cambia los permisos de archivo para lectura y escritura. El cmdlet no puede invalidar las restricciones de seguridad cuando se usa este parámetro.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeInvocationHeader
Indica que este cmdlet registra la marca de tiempo cuando se ejecutan los comandos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Especifica una ubicación para el archivo de transcripción. A diferencia del parámetro Path , el valor del parámetro LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples informan a PowerShell de no interpretar ningún carácter como secuencias de escape.
Type: | String |
Aliases: | PSPath, LP |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoClobber
Indica que este cmdlet no sobrescribe un archivo existente. De forma predeterminada, si existe un archivo de transcripción en la ruta de acceso especificada, Start-Transcript
sobrescribe el archivo sin advertencia.
Type: | SwitchParameter |
Aliases: | NoOverwrite |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputDirectory
Especifica una ruta de acceso y una carpeta específicas en las que guardar una transcripción. PowerShell asigna automáticamente el nombre de la transcripción.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica una ubicación para el archivo de transcripción. Escriba una ruta de acceso a un .txt
archivo. No se permiten caracteres comodín. Si alguno de los directorios de la ruta de acceso no existe, se produce un error en el comando.
Si no especifica una ruta de acceso, Start-Transcript
usa la ruta de acceso en el valor de la $Transcript
variable global. Si no ha creado esta variable, Start-Transcript
almacena las transcripciones en la ubicación y el nombre de archivo predeterminados.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMinimalHeader
Anteponer un encabezado corto a la transcripción, en lugar del encabezado detallado incluido de forma predeterminada. Este parámetro se agregó en PowerShell 6.2.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
No se pueden canalizar objetos a este cmdlet.
Salidas
Este cmdlet 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, use el Stop-Transcript
cmdlet .
Para registrar una sesión completa, agregue el Start-Transcript
comando al perfil. Para obtener más información, consulte about_Profiles.
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de