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 cmdlet Start-Transcript 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 tutti gli output visualizzati 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), per impostazione predefinita Start-TranscriptUtf8NoBom codifica nel file di destinazione.
Esempio
Esempio 1: Avviare un file di trascrizione con le impostazioni predefinite
Start-TranscriptQuesto comando avvia una trascrizione nel percorso del file predefinito.
Esempio 2: Avviare un file di trascrizione in un percorso specifico
Start-Transcript -Path "C:\transcripts\transcript0.txt" -NoClobberQuesto comando avvia una trascrizione nel file Transcript0.txt in C:\transcripts.
parametro di NoClobber impedisce la sovrascrittura dei file esistenti. Se il file Transcript0.txt 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 condivisione file \\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-TranscriptIl percorso completo del file di trascrizione viene archiviato nella variabile di preferenza $Transcript. Per altre informazioni sulla variabile di preferenza $Transcript, vedere about_Preference_Variables.
Parametri
-Append
Indica che questo cmdlet aggiunge la nuova trascrizione alla fine di un file esistente. Usare il parametro Percorso 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 a un file di sola lettura esistente. Se usato in un file di sola lettura, il cmdlet modifica l'autorizzazione 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 digitato. Nessun carattere viene interpretato come caratteri 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 file .txt. 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 variabile globale $Transcript. 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 cosa accadrebbe se il cmdlet viene eseguito. 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 cmdlet Stop-Transcript.
Per registrare un'intera sessione, aggiungere il comando Start-Transcript al profilo. Per altre informazioni, vedere about_Profiles.
