Ecrire dans la sortie standard à l'intérieur des rappels et des fonctions

Un effet utile de la distinction entre Write-Host et Write-Output est que vous pouvez insérer des logs (Write-Host) dans vos fonctions sans perturber les valeurs qu'elles retournent effectivement à leurs appelants (Write-Output).

En parlant de retour aux appelants, laisser simplement une valeur sortir d'une expression ou de l'invocation d'une commande la transmettra en sortie. Par conséquent, 5 sur une ligne à lui seul et Write-Output 5 sont équivalents. Un concept quelque peu délicat est que les scripts PowerShell n'ont pas de valeurs de retour au sens propre comme la plupart des langages de programmation. Retourner une valeur avec le mot clé Return est indiscernable du fait de laisser la valeur sortir de la pipeline de sortie puis de quitter la fonction. En d'autres termes, 5; break est la même chose que Return 5. La sortie du script (qui peut être plusieurs objets) est la valeur de retour.

Les objets sortant des blocs de script enregistrés en tant qu'actions d'événement sont automatiquement stockés dans la propriété Output de l'objet job de l'événement, c'est ce que vous obtenez en retour de Register-ObjectEvent si vous utilisez -Action pour fournir un bloc de script. Voici un exemple de script qui enregistre la date et l'heure actuelles à chaque fois qu'un minuteur se déclenche :

$timer = New-Object System.Timers.Timer
$timer.Interval = 2000
$myEvent = Register-ObjectEvent $timer -EventName 'Elapsed' -Action {Get-Date}
$timer.Start()

La variable $myEvent recevra l'objet job de Register-ObjectEvent. $myEvent.Output sera un tableau en constante augmentation des horaires, un à chaque exécution de Get-Date dans le gestionnaire d'événements. (Il y a quelques variables automatiquement définies qui peuvent être utiles dans de tels gestionnaires.) Dans votre cas, une fois que tout ce qui génère les rappels est terminé, vous pourriez sortir $ect.Output pour transmettre les données capturées au script appelant.

Alternativement, si vous ne voulez pas gérer des gestionnaires d'événements personnalisés, vous pouvez omettre le bloc de script et plutôt fournir un identifiant de source qui nomme l'abonnement à l'événement. Nous pourrions remplacer la ligne $myEvent de l'exemple précédent par ceci :

Register-ObjectEvent $timer -EventName 'Elapsed' -SourceIdentifier 'MyEvent'

Maintenant les événements vont dans la file d'attente des événements, marqués avec notre identifiant de source. Pour les récupérer plus tard, nous utilisons Get-Event :

Get-Event -SourceIdentifier 'MyEvent'