Start-Transcript

  • Riferimento
Modulo:
Microsoft.PowerShell.Host

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeInvocationHeader

Indica che questo cmdlet registra il timestamp quando vengono eseguiti i comandi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath, LP
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputDirectory

Specifica un percorso e una cartella specifici in cui salvare una trascrizione. PowerShell assegna automaticamente il nome della trascrizione.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseMinimalHeader

Anteporre un'intestazione breve alla trascrizione, anziché l'intestazione dettagliata inclusa per impostazione predefinita. Questo parametro è stato aggiunto in PowerShell 6.2.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

String

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.