Start-Transcript

Crea un record di una sessione completa di Windows PowerShell, o di parte di essa, in un file di testo.

Sintassi

Start-Transcript [[-Path] <string>] [-Append] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrizione

Il cmdlet Start-Transcript crea un record di una sessione completa di Windows PowerShell, o di parte di essa, in un file di testo. La trascrizione include tutti i comandi digitati dall'utente e l'output visualizzato nella console.

Parametri

-Append

Aggiunge la nuova trascrizione alla fine del file esistente. Il parametro Path consente di specificare il file.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Force

Consente al cmdlet di aggiungere la trascrizione a un file di sola lettura esistente. In caso di utilizzo in un file di sola lettura, il cmdlet modifica l'autorizzazione del file in lettura-scrittura. Quando si utilizza il parametro Force, il cmdlet non può ignorare le limitazioni di sicurezza.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-NoClobber

Impedisce che venga sovrascritto, ovvero sostituito, il contenuto di un file esistente. Per impostazione predefinita, se nel percorso specificato è presente un file di trascrizione, Start-Transcript lo sovrascrive senza visualizzare alcun avviso.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Path <string>

Specifica un percorso per il file della trascrizione. Immettere un percorso di un file con estensione txt. Non è consentito l'utilizzo di caratteri jolly.

Se non si specifica un percorso, Start-Transcript utilizza quello presente nel valore della variabile globale $Transcript. Se questa variabile non è stata creata, Start-Transcript archivia le trascrizioni nella directory $Home\Documenti come file \PowerShell_transcript.<time-stamp>.txt.

Se una delle directory incluse nel percorso non esiste, il comando ha esito negativo.

Obbligatorio?	false
Posizione?	1
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno

Non è possibile reindirizzare oggetti a questo cmdlet.

Output

System.String

Start-Transcript restituisce una stringa che contiene un messaggio di conferma e il percorso del file di output.

Note

Per interrompere una transazione, utilizzare il cmdlet Stop-Transcript.

Per registrare un'intera sessione, aggiungere il comando Start-Transcript al proprio profilo. Per ulteriori informazioni, vedere about_Profiles.

Esempio 1

C:\PS>start-transcript

Descrizione
-----------
Tramite questo comando viene avviata una trascrizione nel percorso di file predefinito.

Esempio 2

C:\PS>start-transcript -path c:\transcripts\transcript0.txt -noclobber

Descrizione
-----------
Tramite questo comando viene avviata una trascrizione nel file Transcript0.txt in C:\transcripts. Il parametro NoClobber impedisce che i file esistenti vengano sovrascritti. Se il file Transcript0.txt esiste già, il comando ha esito negativo.

Vedere anche

Stop-Transcript