Projet

Général

Profil

Function Create-ViewSegmentSB

function Create-ViewSegmentSB([String] $VariableName=$(throw "Le nom de la variable doit être précisé."))

Cette fonction affiche le nombre d'éléments reçus dans un segment de pipeline afin de visualiser les améliorations apportées lors d'optimisation.
Un des principes du pipeline est, moins on traite d'objets plus rapide est le traitement.Cette fonction rend visible cette évidence.
 
Comme elle renvoi un objet de type scriptblock, on doit utiliser la syntaxe d'appel d'un scriptblock :
&(ViewSegment "Test")

Un exemple affichant le nombre d'objets passés de segment de pipeline en segment de pipeline :

$DebugPreference="Continue" 

1..20|&(ViewSegment "Premier")|`
 #Filtre les nombres pairs
 Where{ !($_ -band 1) }|&(ViewSegment "Pairs")|`
  #Filtre les nombres divisibles par cinq
 Where{ ($_ % 5) -eq 0 }|&(ViewSegment "DivisibleParCinq")

$DebugPreference="SilentlyContinue" 

Le résultat de son exécution :
 
10
20
DÉBOGUER : Segment Premier (1/5) : 20 éléments trouvés.
DÉBOGUER : Segment Pair (3/5) : 10 éléments trouvés.
DÉBOGUER : Segment DivisibleParCinq (5/5) : 2 éléments trouvés.

L'information (3/5) indique le numéro du segment de pipeline.

Notez que son paramètre, par exemple "DivisibleParCinq", est utilisé pour créer une variable, il ne peut donc pas contenir d'espace, à moins d'utiliser la syntaxe suivante :

&(ViewSegment "{Divisible par cinq}")
 #affiche
DÉBOGUER : Segment {Divisible par cinq} (5/5) : 2 éléments trouvés.