Des exemples pour le quotidien

Génération de fichier de log

Le script suivant permettra de créer un fichier de log pour vos scripts puis d’y ajouter du contenu avec par exemple un statut et la date avec l’heure.

Ci-dessous le script :

Function Write_Log 
    { 
           param( 
           $Log_Path, 
           $Message_Type, 
           $Message 
           ) 
 
           If(!(test-path $Log_Path)){new-item $Log_Path -type file -force} 
           $Date = "[{0:MM/dd/yy} {0:HH:mm:ss}]" -f (Get-Date) 
           Add-Content $Log_Path  "$Date - $Message_Type :  $Message" 
           write-host  "$MyDate - $Message_Type : $Message" 
    } 

Celui-ci comporte trois paramètres :

Fonction de création de clé de registre

Cette fonction permettra de créer une clé de registre ou une valeur facilement.

Ci-dessous le script :

Function Set_Reg 
    { 
           param( 
           $Location, 
           $Name, 
           $Value, 
           $Type, 
           $Scope 
           ) 
 
           $Full_Reg_Key_Location = "$Scope" + ":\" + "$Location" 
           If(!(test-path $Full_Reg_Key_Location)){New-Item  
-Path $Full_Reg_Key_Location | out-null} 
 
           Try 
           { 
                 New-ItemProperty -Path $Full_Reg_Key_Location 
-Name $Name -Type $Type -Value $Value -Force -ea silentlycontinue...

Vérifier la validité d’un lien web

Il peut être utile de récupérer des informations depuis un site internet ou télécharger du contenu et donc de vérifier si ce site est fonctionnel et joignable.

L’idée sera de tester si un site web répond, un peu comme on pourrait le faire avec un ping sur un poste ou une adresse IP. Le lien du fichier que nous souhaitons vérifier est le suivant : https://github.com/damienvanrobaeys/ServiceUI/blob/main/ServiceUI.exe

Pour vérifier la connectivité, nous utiliserons la cmldet Invoke-WebRequest :

$Check_URL = invoke-webrequest $URL -UseBasicParsing 

ou :

$Check_URL = wget $URL -UseBasicParsing 

Nous vérifierons ensuite la valeur de la propriété StatusCode.

$Status = $Check_URL.StatusCode 
If($Status -eq 200){write-host "OK"}Else{write-host "KO"} 

Si la réponse est 200, alors le lien est valide.

Nous pouvons également utiliser le code suivant :

$Check_URL = [System.Net.WebRequest]::Create($URL) 
$Status = ($Check_URL.GetResponse()).StatusCode 

Ajoutons un caractère dans l’URL pour vérifier le résultat.

La réponse en erreur indique que le lien n’est pas joignable et donc non valide.

Nous pouvons créer une fonction rapide qui nous permet de tester la validité d’une URL.

Function Get_URLStatus ...

$Fichier = "C:\ENI\ServiceUI.exe" 

Invoke-WebRequest -Uri $URL -OutFile $Fichier 

$WebClient = New-Object System.Net.WebClient 

$WebClient.DownloadFile($URL,$Fichier) 

$Fichier = "C:\ENI\Capture.png" 
Add-Type -AssemblyName System.Windows.Forms 
Add-type -AssemblyName System.Drawing 
$Screen = [System.Windows.Forms.SystemInformation]::VirtualScreen 
$Width = $Screen.Width 
$Height = $Screen.Height 
$Left = $Screen.Left 
$Top = $Screen.Top 
$bitmap = New-Object System.Drawing.Bitmap $Width, $Height 
$graphic = [System.Drawing.Graphics]::FromImage($bitmap) 
$graphic.CopyFromScreen($Left, $Top, 0, 0, $bitmap.Size) 
$bitmap.Save($Fichier) 

$A_zipper = "C:\ENI" 
$ZIP_Path = "C:\ENI\MonZIP.zip" 
Compress-Archive -Path $A_zipper -DestinationPath $ZIP_Path -Force 

$UnZIP_Path = "C:\ENI\ZIP" 
Expand-Archive -LiteralPath $ZIP_Path -DestinationPath $UnZIP_Path 

Créer un journal d’évènements et ajouter un évènement

Lors de l’exécution d’une action au travers d’un script qui touche le système, la partie applicative, il peut être très utile de créer un fichier de log afin de savoir plus tard ce qui a été fait. Outre la création d’un fichier, il est également possible de créer une nouvelle entrée dans le gestionnaire Windows, comme le font déjà nativement Windows et de nombreuses applications.

Créer un nouveau journal

L’observateur d’évènements Windows contient différents journaux dont les plus utilisés sont :

Nous allons ici créer un nouveau journal pour les application et les services.

Celui-ci sera un journal dédié à l’exécution de notre ou nos scripts.

L’idée sera donc que tous les scripts exécutés dans notre contexte d’entreprise puissent enregistrer les actions et statuts dans le journal que nous allons créer. Cherchons donc les cmdlets disponibles dans PowerShell permettant de gérer les journaux d’évènements.

Comme mentionné dans le chapitre Quelques bonnes pratiques, il faut prendre l’habitude d’utiliser la cmdlet Get-Command pour chercher...

Exporter un journal d’évènements

Nous souhaitons exporter le contenu d’un journal d’évènements sous la forme d’un fichier. Cela pourra être utile pour dépanner des utilisateurs à distance et récupérer les différentes sources d’informations pour trouver le problème.

Le script à utiliser est le suivant :

Function Export_EventLog 
    { 
           param( 
           $Log, 
           $Output, 
           $File 
           ) 
 
           If(!(test-path $Output)){new-item $Output -Type  
Directory -Force | out-null} 
           Write_Log -Message_Type "INFO" -Message "Récupération 
du journal: $Log" 
           Try 
                 { 
                        WEVTUtil...

New-Guid 

(New-Guid).guid 

[guid]::NewGuid() 

[guid]::NewGuid().guid 

Générer un mot de passe

Nous allons voir ici différentes manières de générer un mot de passe à réutiliser.

Dans ce premier exemple, nous allons utiliser la classe nommée System.Web.Security.Membership. Celle-ci est incluse de base dans votre système d’exploitation Windows.

Pour charger cette classe, nous utiliserons le code ci-dessous :

Add-Type -AssemblyName System.Web 

Pour générer le mot de passe, nous utiliserons la méthode nommée GeneratePassword incluse dans cette classe.

[System.Web.Security.Membership]::GeneratePassword() 

La méthode GeneratePassword utilise deux paramètres pour générer le mot de passe :

Cela s’utilisera de la manière suivante :

[System.Web.Security.Membership]::GeneratePassword(Param1,Param2) 

Dans l’exemple suivant, nous allons créer un mot de passe contenant cinq caractères avec cinq caractères spéciaux :

[System.Web.Security.Membership]::GeneratePassword(5,5) 

Ci-dessous le résultat obtenu :

Dans l’exemple suivant, nous allons créer un mot de passe contenant dix caractères avec quatre caractères spéciaux :...

Get-EventLog Security -InstanceId 4732 -ea silentlycontinue |  
Format_List 

Get-WinEvent -LogName Security | where {$_.Id -eq 4732} |  
Select-String -InputObject {$_.message} -Pattern 'Administrators' 

Identifier les comptes administrateurs locaux

Dans l’exemple suivant, nous allons utiliser PowerShell afin de vérifier les postes pour lesquels un compte utilisateur a été ajouté en tant qu’administrateur local, c’est-à-dire dans le groupe Administrateurs. En effet, il n’est pas vraiment recommandé de laisser les utilisateurs être administrateurs de leur poste si ce poste est géré par une entreprise. Cela permettra d’éviter de nombreux problèmes tels qu’un utilisateur qui a installé ou désinstallé une application, un driver ou autre. S’il s’agit du poste personnel de l’utilisateur, c’est bien entendu différent.

Nous définirons un compte qui aura le droit d’être dans le groupe Administrateurs. Notre script effectuera les actions suivantes :

Ci-dessous le script concerné :

$Get_Local_AdminGroup = Gwmi win32_group -Filter "Domain= 
'$env:computername' and SID='S-1-5-32-544'" 
$Get_Local_AdminGroup_Name = $Get_Local_AdminGroup.Name 
$Get_Administrator_Name = $Get_Local_AdminGroup_Name -replace ".$" 
$Authorized_Accounts += $Get_Administrator_Name ...

Obtenir la date de dernier redémarrage

Il s’agit ici de la date de dernier redémarrage ou, autrement dit, la date depuis laquelle le poste est allumé. Lorsqu’un utilisateur rencontre un problème, il arrive régulièrement qu’un simple redémarrage de la machine le résolve, car trop souvent le poste n’est pas redémarré régulièrement. Il peut donc être utile d’obtenir la date de dernier redémarrage avec PowerShell.

Il est possible de l’obtenir simplement en interrogeant la classe WMI Win32_OperatingSystem et la propriété LastBootUpTime.

PS C:\Users\damien.vanrobaeys> (Get-CimInstance -ClassName  
Win32_OperatingSystem).LastBootUpTime 
 
jeudi 20 octobre 2022 09:06:49 

Cependant, cette méthode a une limite et peut parfois retourner la mauvaise date. En effet, si l’option de démarrage rapide de Windows est activée sur le poste, la date de dernier redémarrage utilisant LastBootUpTime peut être fausse. Dans ce cas, si l’utilisateur éteint son poste au lieu de le redémarrer, la commande mentionnée plus haut retournera quand même que le poste n’a pas été redémarré depuis x jours ou heures. La propriété LastBootUpTime attendra véritablement un vrai redémarrage pour changer la date. Nous obtenons également le même résultat dans la partie Performances du Gestionnaire des tâches.

Quel peut être l’impact ?

Prenons l’exemple suivant : nous souhaitons planifier tous les trois jours un script permettant d’afficher une notification de redémarrage à l’utilisateur (si le poste n’a pas été redémarré depuis plus de deux jours).

Si l’option démarrage rapide est activée et que l’utilisateur a l’habitude d’éteindre son poste tous les jours, il risque de recevoir régulièrement la notification alors que, pour lui, un arrêt du poste est identique à un redémarrage.

Comment résoudre cela ?

Il faudra pour cela :

$Run_As_Admin = ([Security.Principal.WindowsPrincipal]  
[Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole 
([Security.Principal.WindowsBuiltInRole]::Administrator) 
If($Run_As_Admin -eq $False) 
    { 
           write-warning "non admin" 
           break 
    }