| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente |
| powershell_base1 [2019/12/05 15:50] – nekan | powershell_base1 [2021/07/22 08:47] (Version actuelle) – [ForEach-Object] nekan |
|---|
| ~~CLOSETOC~~ | |
| ====== Les bases de Powershell - 1ère partie ====== | ====== Les bases de Powershell - 1ère partie ====== |
| | <label type="info">Création</label> --- //[[nekan@shyrkasystem.com|Nicolas THOREZ]] 2019/02/20 20:43// |
| |
| Je vais juste récapituler ici certaines bases très utiles dans la plupart des scripts. | Je vais juste récapituler ici certaines bases très utiles dans la plupart des scripts. |
| $true | $true |
| </sxh> | | </sxh> | |
| | ''-gt'' | supérieur à |Renvoie ''$true'' si la première variable est strictement supérieur à la seconde |<sxh powershell>2 -gt 1 | | ''-gt'' | supérieur à |Renvoie ''$true'' si la première variable est strictement supérieure à la seconde |<sxh powershell>2 -gt 1 |
| $true | $true |
| 2 -gt 2 | 2 -gt 2 |
| $false | $false |
| </sxh>| | </sxh>| |
| | ''-ge'' | supérieur ou égal à |Renvoie ''$true'' si la première variable est supérieur ou égal à la seconde |<sxh powershell>2 -ge 1 | | ''-ge'' | supérieur ou égal à |Renvoie ''$true'' si la première variable est supérieure ou égale à la seconde |<sxh powershell>2 -ge 1 |
| $true | $true |
| 2 -ge 2 | 2 -ge 2 |
| $true | $true |
| </sxh>| | </sxh>| |
| | ''-lt'' | inférieur à |Renvoie ''$true'' si la première variable est strictement inférieur à la seconde |<sxh powershell>1 -lt 2 | | ''-lt'' | inférieur à |Renvoie ''$true'' si la première variable est strictement inférieure à la seconde |<sxh powershell>1 -lt 2 |
| $true | $true |
| 2 -lt 2 | 2 -lt 2 |
| $false | $false |
| </sxh>| | </sxh>| |
| | ''-ge'' | inférieur ou égal à |Renvoie ''$true'' si la première variable est inférieur ou égal à la seconde |<sxh powershell>1 -le 2 | | ''-le'' | inférieur ou égal à |Renvoie ''$true'' si la première variable est inférieure ou égale à la seconde |<sxh powershell>1 -le 2 |
| $true | $true |
| 2 -le 2 | 2 -le 2 |
| </sxh> | | </sxh> | |
| |
| Comme pour les opérateurs d'égalité, ces opérateurs sont par défaut insensibles à la casse. Les modificateurs ''c'' et ''i'' peuvent être utilisés. | Comme pour les opérateurs d'égalité, ces opérateurs sont par défaut insensibles à la casse. Les modificateurs ''c'' et ''i'' peuvent être utilisés. |
| | Les opérateurs de type ''match'' peut utiliser les expressions régulières dans leur recherche de correspondances (voir [[powershell_regex|Les expressions régulières (regex)]]). |
| ==== Inclusion ==== | ==== Inclusion ==== |
| |
| $true | $true |
| </sxh> | | </sxh> | |
| | ''-notcontains'' | n'est pas contenu dans |Renvoie ''$true'' si une des deux variables est contenu dans la collection d'élément de l'autre variable. Les tests sont réalisé sur les références des variables et non leur valeur. | <sxh powershell>"Nicolas","Jean","Marc" -notcontains "Nicolas","Paul" | | ''-notcontains'' | n'est pas contenu dans |Renvoie ''$true'' si une des deux variables n'est pas contenu dans la collection d'élément de l'autre variable. Les tests sont réalisé sur les références des variables et non leur valeur. | <sxh powershell>"Nicolas","Jean","Marc" -notcontains "Nicolas","Paul" |
| $true | $true |
| </sxh> | | </sxh> | |
| $true | $true |
| </sxh> | | </sxh> | |
| | ''-notin'' | n'est pas contenu dans |Renvoie ''$true'' si une des deux variables est contenu dans la collection d'élément de l'autre variable. Les tests sont réalisé sur les valeurs des variables et non leur référence. | <sxh powershell>$Nom = "Nicolas","Paul" | | ''-notin'' | n'est pas contenu dans |Renvoie ''$true'' si une des deux variables n'est pas contenu dans la collection d'élément de l'autre variable. Les tests sont réalisé sur les valeurs des variables et non leur référence. | <sxh powershell>$Nom = "Nicolas","Paul" |
| "Nicolas","Jean","Marc" -notin $Nom | "Nicolas","Jean","Marc" -notin $Nom |
| $true | $true |
| Switch ($Entry) # On teste la valeur de $Entry. On pourrait aussi faire une opération logique | Switch ($Entry) # On teste la valeur de $Entry. On pourrait aussi faire une opération logique |
| { # On ouvre le bloc d'exécution de Switch | { # On ouvre le bloc d'exécution de Switch |
| 1 { Write-Host 'Age: 1' } # Si c'est 1, on écrit Age: 1 | 1 { Write-Host "Age: 1" } # Si c'est 1, on écrit Age: 1 |
| 2 { Write-Host 'Age: 2' } # Si c'est 2, on écrit Age: 2 | 2 { Write-Host "Age: 2" } # Si c'est 2, on écrit Age: 2 |
| 99 { Write-Host 'Age: 99' } # Si c'est 99, on écrit Age: 99 | 99 { Write-Host "Age: 99" } # Si c'est 99, on écrit Age: 99 |
| default { Write-Host 'Je sais pas' } # Sinon, on écrit Je sais pas | default { Write-Host "Je sais pas" } # Sinon, on écrit Je sais pas |
| } # On ferme le bloc | } # On ferme le bloc |
| </sxh> | </sxh> |
| |
| | ''Switch'' est par défaut insensible à la casse. Ainsi, ''a'' sera traité de la même manière que ''A''. Si les deux résultats sont dans la liste des résultats attendus alors le traitement sera effectué sur chaque entrée de la liste. Pour éviter ce fonctionnement ou pour rendre ''Switch'' sensible à la casse on peut ajouter le paramètre ''-CaseSensitive''. |
| | |
| | <sxh powershell>$Letter = "a" |
| | Switch ($Letter) |
| | { |
| | "a" { Write-Host "Lettre a" } |
| | "A" { Write-Host "Lettre A" } |
| | } |
| | |
| | # Retour |
| | Lettre a |
| | Lettre A |
| | |
| | $Letter = "a" |
| | Switch -CaseSensitive ($Letter) |
| | { |
| | "a" { Write-Host "Lettre a" } |
| | "A" { Write-Host "Lettre A" } |
| | } |
| | |
| | # Retour |
| | Lettre a</sxh> |
| ===== Les boucles ===== | ===== Les boucles ===== |
| |
| Les boucles permettent de répéter un code un certain nombre de fois. | Les boucles permettent de répéter un code un certain nombre de fois. |
| |
| <note important>Il faut toujours faire attention à ne pas créer une boucle infinie. Pensez à prévoir une porte de sortie.</note> | <callout type="warning" icon="true" title="Boucle infinie">Il faut toujours faire attention à ne pas créer une boucle infinie. Pensez à prévoir une porte de sortie.</callout> |
| |
| ==== ForEach-Object ==== | ==== ForEach-Object ==== |
| 5 | 5 |
| </sxh> | </sxh> |
| | |
| | === Parallélisation === |
| | |
| | * Référence : [[https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/foreach-object?view=powershell-7|Microsoft]] |
| | |
| | <callout type="warning" icon="true" title="Mise à jour du 22/02/2020">Dans Powershell Core, **ForEach** n'est plus la même chose que **ForEach-Object**. |
| | * **ForEach-Object** : Permet la gestion des éléments du pipeline. Dispose désormais de l'option ''-Parallel'' permettant la gestion de plusieurs boucles en simultané (parallélisation). |
| | * **ForEach** : Ne prend pas en charge ni le pipeline ni la parallélisation. Traite uniquement un nombre défini d'itération. |
| | </callout> |
| | |
| | <callout type="warning" icon="true" title="Version">Cet exemple n'est valable qu'en Powershell Core (version 7 ou supérieure).</callout> |
| | |
| | Dans cette exemple, on crée une boucle qui va attendre 30 fois 1 seconde soit théoriquement un total de 30 secondes : |
| | <sxh powershell>(Measure-Command { 1..30 | ForEach-Object { Start-Sleep -Seconds 1 } }).Seconds |
| | 30</sxh> |
| | |
| | En activant le paramètre ''-Parallel'' : |
| | <sxh powershell>(Measure-Command { 1..30 | ForEach-Object -Parallel { Start-Sleep -Seconds 1 } }).Seconds |
| | 6</sxh> |
| | |
| | La commande n'a mis que 6 secondes car la parallélisation a traitée 5 commandes (valeur par défaut) en concurrence. Le paramètre ''-ThrottleLimit'' permet de définir le nombre de commandes concurrentes : |
| | <sxh powershell>(Measure-Command { 1..30 | ForEach-Object -Parallel { Start-Sleep -Seconds 1 } -ThrottleLimit 10 }).Seconds |
| | 3</sxh> |
| | |
| | La parallélisation permet d'améliorer le temps d'exécution des scripts mais attention tout de même. Chaque concurrent va créer son propre espace de travail (''runspace''), traiter la commande et le clore. Dans certains cas, ces multiples actions d'ouvertures et fermetures sont plus longues que le traitement, ce qui entraîne une augmentation global de la durée d'exécution du script. Par exemple : |
| | <sxh powershell>(Measure-Command { Get-Process | ForEach-Object { Write-Host $_.Name } }).Milliseconds |
| | 91 |
| | (Measure-Command { Get-Process | ForEach-Object -Parallel { Write-Host $_.Name } }).Milliseconds |
| | 995</sxh> |
| | |
| | <callout type="info" icon="true" title="Parallélisation">La parallélisation est donc très intéressante mais à utiliser avec sagesse.</callout> |
| |
| ==== For ==== | ==== For ==== |
| |
| <sxh powershell> | <sxh powershell> |
| For ( $i=0 ; $i -lt 5 ; $i++ ) # On part de 0, on teste si $i est inférieur à 5 et à chaque boucle on ajoute 1 à $1 | For ( $i=0 ; $i -lt 5 ; $i++ ) # On part de 0, on teste si $i est inférieur à 5 et à chaque boucle on ajoute 1 à $i |
| { # On ouvre le bloc | { # On ouvre le bloc |
| Write-Host $i # On écrit la valeur de $i | Write-Host $i # On écrit la valeur de $i |
| |
| ''Do'' va exécuter un code puis effectuer un test. Selon le résultat de ce test, il continuera ou arrêtera la boucle. Le test est introduit par les commande ''Until'' ou ''While''. | ''Do'' va exécuter un code puis effectuer un test. Selon le résultat de ce test, il continuera ou arrêtera la boucle. Le test est introduit par les commande ''Until'' ou ''While''. |
| * ''Until'' : on continue tant que le résultat du test n'est pas $true. | * ''Until'' : on continue jusqu'à ce que le résultat du test soit $true. |
| * ''While'' : on continue jusqu'à ce que le résultat du test soit $false. | * ''While'' : on continue tant que le résultat du test est $true. |
| |
| <sxh powershell> | <sxh powershell> |
| # du test aurait renvoyé $false | # du test aurait renvoyé $false |
| </sxh> | </sxh> |
| |
| --- //[[nekan@shyrkasystem.com|Nicolas THOREZ]] 2019/02/20 20:43// | |
| |
| ~~DISCUSSION~~ | ~~DISCUSSION~~ |