Activer la transcription PowerShell
Turn on PowerShell Transcription
Explication
Ce paramètre de stratégie vous permet de capturer l'entrée et la sortie de commandes Windows PowerShell dans le texte de transcription.
Si vous activez ce paramètre de stratégie, Windows PowerShell activera la transcription pour Windows PowerShell, Windows PowerShell ISE et toute autre
application qui s'appuie sur le moteur Windows PowerShell. Par défaut, Windows PowerShell enregistrera les sorties de transcription dans le répertoire « Mes documents » de chaque utilisateur
avec un nom de fichier comprenant « PowerShell_transcript », ainsi que l'heure de début et le nom de l'ordinateur. L'activation de cette stratégie revient
à appeler l'applet de commande Start-Transcript sur chaque session Windows PowerShell.
Si vous désactivez ce paramètre de stratégie, la transcription des applications basées sur PowerShell est désactivée par défaut, même si elle peut toujours être activée
par le biais de l'applet de commande Start-Transcript.
Si vous utilisez le paramètre OutputDirectory pour activer la journalisation des transcriptions dans un emplacement partagé, veillez à limiter l'accès à ce répertoire pour empêcher les utilisateurs
de voir les transcriptions d'autres utilisateurs ou ordinateurs.
Remarque : ce paramètre de stratégie se trouve sous Configuration ordinateur et Configuration utilisateur dans l'éditeur de stratégie de groupe. Le paramètre de stratégie de Configuration ordinateur est prioritaire sur le paramètre de stratégie de Configuration utilisateur.
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.
Cas d'usage
Capture dans des fichiers texte l’entrée et la sortie de toutes les sessions PowerShell, comme si Start-Transcript était lancé à chaque session. Utile pour l’audit des sessions d’administration sur des serveurs sensibles.
Par défaut, les transcriptions vont dans Mes documents de chaque utilisateur : indiquez un répertoire de sortie centralisé et restreignez-en l’accès, sinon les utilisateurs pourraient lire les transcriptions des autres.
Source Microsoft : about_Group_Policy_Settings
Registre
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\PowerShell\TranscriptionHKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\PowerShell\Transcription- Nom de la valeur
EnableTranscripting
| État | Valeur écrite |
|---|---|
| Activé | REG_DWORD = 1 |
| Désactivé | REG_DWORD = 0 |
PowerShell
Commandes PowerShell qui écrivent dans le registre ce que la stratégie écrirait. Les valeurs entre chevrons (<…>) sont à remplacer.
Écrire directement dans le registre contourne la stratégie de groupe : si une GPO gère cette valeur, elle sera réécrite au prochain gpupdate ; sinon la valeur reste en place (effet « tatouage »). Préférez une GPO ou, en local, LGPO.exe. Exécutez PowerShell en administrateur pour HKLM. Certaines stratégies demandent un redémarrage ou gpupdate /force.
Ordinateur (HKLM)
Activer
# Activer : PowerShellExecutionPolicy/EnableTranscripting
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\Transcription'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableTranscripting' -Value 1 -Type DWord
# Répertoire de sortie de transcription
Set-ItemProperty -Path $k -Name 'OutputDirectory' -Value '<valeur>' -Type String
# Inclure les en-têtes de l'appel
# valeur non définie dans l'ADMX (l'éditeur GPO écrit en général 1/0)
# 1 = coché, 0 = décoché ; état par défaut de la case repris de l’ADML
Set-ItemProperty -Path $k -Name 'EnableInvocationHeader' -Value 1 -Type DWordDésactiver
# Désactiver : PowerShellExecutionPolicy/EnableTranscripting
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\Transcription'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableTranscripting' -Value 0 -Type DWordRevenir à « Non configuré »
# Revenir à « Non configuré » : PowerShellExecutionPolicy/EnableTranscripting
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\Transcription'
Remove-ItemProperty -Path $k -Name 'EnableTranscripting' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'OutputDirectory' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'EnableInvocationHeader' -ErrorAction SilentlyContinueUtilisateur (HKCU)
Activer
Désactiver
Revenir à « Non configuré »
Options (2)
| Libellé | Contrôle | Valeur de registre | Type REG | Contraintes / détails |
|---|---|---|---|---|
| Répertoire de sortie de transcriptionTranscript output directoryOutputDirectory | Zone de textetext | OutputDirectory | REG_SZ | |
| Inclure les en-têtes de l'appel :Include invocation headers:EnableInvocationHeader | Case à cocherboolean | EnableInvocationHeader | REG_DWORD | Coché : implicite : 1Décoché : implicite : 0 |