Activer l’enregistrement des modules
Turn on Module Logging
Explication
Ce paramètre de stratégie vous permet d’activer ou de désactiver l’enregistrement des modules Windows PowerShell.
Si vous activez ce paramètre de stratégie, les événements d’exécution du pipeline pour les membres des modules spécifiés sont enregistrés dans le journal Windows PowerShell de l’observateur d’événements. L’activation de ce paramètre de stratégie pour un module revient en fait à attribuer la valeur True à la propriété LogPipelineExecutionDetails du module.
En désactivant ce paramètre de stratégie, vous désactivez également l’enregistrement des événements d’exécution pour tous les modules Windows PowerShell. La désactivation de ce paramètre de stratégie pour un module revient en fait à attribuer la valeur False à la propriété LogPipelineExecutionDetails du module.
Si vous ne configurez pas ce paramètre de stratégie, la propriété LogPipelineExecutionDetails d’un module ou d’un composant logiciel enfichable détermine si les événements d’exécution d’un module ou d’un composant logiciel enfichable sont enregistrés. Par défaut, la propriété LogPipelineExecutionDetails de tous les modules et composants logiciels enfichables est définie sur False.
Pour ajouter des modules et des composants logiciels enfichables à la liste des paramètres de stratégie, cliquez sur Afficher, puis entrez les noms des modules dans la liste. Vous devez installer les modules et les composants logiciels enfichables sur l’ordinateur.
Remarque : ce paramètre de stratégie est présent sous Configuration ordinateur et Configuration utilisateur dans l’Éditeur d’objets de stratégie de groupe. Le paramètre de stratégie de Configuration ordinateur a priorité sur celui de Configuration utilisateur.
This policy setting allows you to turn on logging for Windows PowerShell modules.
If you enable this policy setting, pipeline execution events for members of the specified modules are recorded in the Windows PowerShell log in Event Viewer. Enabling this policy setting for a module is equivalent to setting the LogPipelineExecutionDetails property of the module to True.
If you disable this policy setting, logging of execution events is disabled for all Windows PowerShell modules. Disabling this policy setting for a module is equivalent to setting the LogPipelineExecutionDetails property of the module to False.
If this policy setting is not configured, the LogPipelineExecutionDetails property of a module or snap-in determines whether the execution events of a module or snap-in are logged. By default, the LogPipelineExecutionDetails property of all modules and snap-ins is set to False.
To add modules and snap-ins to the policy setting list, click Show, and then type the module names in the list. The modules and snap-ins in the list must be installed on the computer.
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
Consigne les événements d’exécution de pipeline pour les modules que vous listez (par exemple « * » pour tous). Complète la journalisation des blocs de script en montrant les cmdlets appelées et leurs paramètres.
Si la stratégie n’est pas configurée, c’est la propriété LogPipelineExecutionDetails de chaque module qui décide (désactivée par défaut) ; désactivée, plus aucun événement n’est journalisé.
Sources Microsoft : about_Group_Policy_Settings · about_Logging_Windows
Registre
HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\PowerShell\ModuleLoggingHKEY_CURRENT_USER\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging- Nom de la valeur
EnableModuleLogging
| É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/EnableModuleLogging
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableModuleLogging' -Value 1 -Type DWord
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging\ModuleNames'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Noms des modules
# Liste non additive : les valeurs existantes de la clé sont d'abord effacées
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$values = @('<valeur1>', '<valeur2>') # Remplacez les valeurs par les vôtres
foreach ($v in $values) { Set-ItemProperty -Path $k -Name $v -Value $v -Type String }Désactiver
# Désactiver : PowerShellExecutionPolicy/EnableModuleLogging
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableModuleLogging' -Value 0 -Type DWordRevenir à « Non configuré »
# Revenir à « Non configuré » : PowerShellExecutionPolicy/EnableModuleLogging
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging'
Remove-ItemProperty -Path $k -Name 'EnableModuleLogging' -ErrorAction SilentlyContinue
$k = 'HKLM:\Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging\ModuleNames'
Remove-Item -Path $k -Recurse -Force -ErrorAction SilentlyContinueUtilisateur (HKCU)
Activer
Désactiver
Revenir à « Non configuré »
Options (1)
| Libellé | Contrôle | Valeur de registre | Type REG | Contraintes / détails |
|---|---|---|---|---|
| Noms des modulesModule NamesListbox_ModuleNames | Liste (tableau)list | Software\Policies\Microsoft\Windows\PowerShell\ModuleLogging\ModuleNamesValeurs numérotées (1, 2, 3…) | REG_SZ (valeurs sous la clé) |