Start-Transcript
Crea un record di una sessione di PowerShell o di una parte in un file di testo.
Sintassi
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>]
Descrizione
Il Start-Transcript
cmdlet crea un record di tutta o parte di una sessione di PowerShell in un file di testo. La trascrizione include tutti i comandi digitati dall'utente e tutto l'output visualizzato nella console.
Per impostazione predefinita, Start-Transcript
archivia la trascrizione nel percorso seguente usando il nome predefinito:
- In Windows:
$HOME\Documents
- In Linux o macOS:
$HOME
Il nome file predefinito è PowerShell_transcript.<computername>.<random>.<timestamp>.txt
.
A partire da Windows PowerShell 5.0, Start-Transcript
include il nome host nel nome file generato di tutte le trascrizioni. Il nome file include anche caratteri casuali nei nomi per evitare potenziali sovrascrizioni o duplicazioni all'avvio simultaneo di due o più trascrizioni. L'inclusione del nome del computer è utile se si archiviano le trascrizioni in una posizione centralizzata. La stringa di caratteri casuali impedisce di indovinare il nome del file per ottenere l'accesso non autorizzato al file.
Se il file di destinazione non ha un byte Order Mark (BOM), Start-Transcript
per impostazione predefinita viene Utf8NoBom
impostata la codifica nel file di destinazione.
Esempio
Esempio 1: Avviare un file di trascrizione con le impostazioni predefinite
Start-Transcript
Questo comando avvia una trascrizione nel percorso di file predefinito.
Esempio 2: Avviare un file di trascrizione in un percorso specifico
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobber
Questo comando avvia una trascrizione nel Transcript0.txt
file in C:\transcripts
. Il parametro NoClobber impedisce la sovrascrittura dei file esistenti. Se il Transcript0.txt
file esiste già, il comando ha esito negativo.
Esempio 3: Avviare un file di trascrizione con un nome univoco e archiviarlo in una condivisione file
Nell'esempio seguente viene creato un file di trascrizione con un nome univoco sufficiente per essere archiviato in un percorso condiviso. Il nome file viene costruito dal nome dell'utente, dal nome host del computer che esegue PowerShell, dalla versione di PowerShell e dalla data e dall'ora. La trascrizione viene archiviata nella \\Server01\Transcripts
condivisione file.
$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
Il percorso completo del file di trascrizione viene archiviato nella $Transcript
variabile di preferenza. Per altre informazioni sulla variabile di $Transcript
preferenza, vedere about_Preference_Variables.
Parametri
-Append
Indica che questo cmdlet aggiunge la nuova trascrizione alla fine di un file esistente. Usare il parametro Path per specificare il file.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Force
Consente al cmdlet di aggiungere la trascrizione alla fine di un file di sola lettura esistente. Se usato in un file di sola lettura, il cmdlet cambia l'autorizzazione per il file in lettura-scrittura. Il cmdlet non può eseguire l'override delle restrizioni di sicurezza quando viene usato questo parametro.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-IncludeInvocationHeader
Indica che questo cmdlet registra il timestamp quando vengono eseguiti i comandi.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-LiteralPath
Specifica un percorso del file di trascrizione. A differenza del parametro Path , il valore del parametro LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.
Tipo: | String |
Alias: | PSPath, LP |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-NoClobber
Indica che questo cmdlet non sovrascrive un file esistente. Per impostazione predefinita, se nel percorso specificato esiste un file di trascrizione, Start-Transcript
sovrascrive il file senza avviso.
Tipo: | SwitchParameter |
Alias: | NoOverwrite |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OutputDirectory
Specifica un percorso e una cartella specifici in cui salvare una trascrizione. PowerShell assegna automaticamente il nome della trascrizione.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Path
Specifica un percorso del file di trascrizione. Immettere un percorso di un .txt
file. I caratteri jolly non sono consentiti. Se una delle directory nel percorso non esiste, il comando ha esito negativo.
Se non si specifica un percorso, Start-Transcript
usa il percorso nel valore della $Transcript
variabile globale. Se questa variabile non è stata creata, Start-Transcript
archivia le trascrizioni nel percorso e nel nome file predefiniti.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-UseMinimalHeader
Anteporre un'intestazione breve alla trascrizione, anziché l'intestazione dettagliata inclusa per impostazione predefinita. Questo parametro è stato aggiunto in PowerShell 6.2.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Input
None
Non è possibile inviare tramite pipe oggetti a questo cmdlet.
Output
Questo cmdlet restituisce una stringa contenente un messaggio di conferma e il percorso del file di output.
Note
Per arrestare una trascrizione, usare il Stop-Transcript
cmdlet .
Per registrare un'intera sessione, aggiungere il Start-Transcript
comando al profilo. Per altre informazioni, vedere about_Profiles.