Turn on PowerShell Transcription
Jump to overview

Policy overview

Key metadata and intent for this policy.

Category
Windows Components > Windows PowerShell
Supported on
At least Microsoft Windows 7 or Windows Server 2008 family

Supported OS tags: Windows7, WindowsServer2008

This policy setting lets you capture the input and output of Windows PowerShell commands into text-based transcripts. If you enable this policy setting, Windows PowerShell will enable transcripting for Windows PowerShell, the Windows PowerShell ISE, and any other applications that leverage the Windows PowerShell engine. By default, Windows PowerShell will record transcript output to each users' My Documents directory, with a file name that includes 'PowerShell_transcript', along with the computer name and time started. Enabling this policy is equivalent to calling the Start-Transcript cmdlet on each Windows PowerShell session. If you disable this policy setting, transcripting of PowerShell-based applications is disabled by default, although transcripting can still be enabled through the Start-Transcript cmdlet. If you use the OutputDirectory setting to enable transcript logging to a shared location, be sure to limit access to that directory to prevent users from viewing the transcripts of other users or computers. Note: This policy setting exists under both Computer Configuration and User Configuration in the Group Policy Editor. The Computer Configuration policy setting takes precedence over the User Configuration policy setting.

Internal name
EnableTranscripting
Policy ID
5321e32dc583
Elements
2

Registry values

How enabled and disabled states update the registry.

ScopeRegistry locationTypeEnabled valueDisabled valueCopy
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
EnableTranscripting
REG_DWORD
HKLM
1
HKCU
1
HKLM
0
HKCU
0
Registry location
Type REG_DWORD · Both
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
EnableTranscripting
Hive
HKLM
Enabled value
1
Disabled value
0
Hive
HKCU
Enabled value
1
Disabled value
0

Policy elements

Inputs and configuration options exposed by this policy.

ScopeElementTypeRegistry mappingConstraints & behaviorCopy
Include invocation headers:
ID EnableInvocationHeader
boolean
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
EnableInvocationHeader
Type
REG_DWORD
Options: true (), false ()
True: None · False: None
Transcript output directory
ID OutputDirectory
text
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
OutputDirectory
Type
REG_SZ
None
Include invocation headers:
Both · Type boolean
Registry mapping
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
EnableInvocationHeader
Type
REG_DWORD
Details
Options: true (), false ()
True: None · False: None
Transcript output directory
Both · Type text
Registry mapping
Path
Software\Policies\Microsoft\Windows\PowerShell\Transcription
Value name
OutputDirectory
Type
REG_SZ
DetailsNone