AvoidAssignmentToAutomaticVariable

Ernstniveau: Waarschuwing

Beschrijving

Deze regel detecteert toewijzingen aan automatische variabelen en parameternamen die automatische variabelennamen gebruiken. PowerShell definieert automatisch variabelen die interne toestandsinformatie opslaan en beheert deze zelfstandig. Hoewel je veel automatische variabelen kunt overschrijven, kan dit onverwachte effecten hebben voor gebruikers en het moeilijker maken om je code te onderhouden en te debuggen.

Vermijd het gebruik van automatische variabelennamen in je functies en parameters. Reserveer automatische variabelen alleen voor het interne gebruik van PowerShell, en vertrouw er alleen op om statusinformatie te lezen.

Voor meer informatie, zie about_Automatic_Variables.

Hoe

Gebruik variabelennamen in functies of hun parameters die niet conflicteren met automatische variabelen.

Example

Niet conform

De variabele $Error is een automatische variabele die in de globale scope bestaat en mag daarom nooit als variabele of parameternaam worden gebruikt.

function foo($Error){ }
function Get-CustomErrorMessage($ErrorMessage){ $Error = "Error occurred: $ErrorMessage" }

Compliant

function Get-CustomErrorMessage($ErrorMessage){ $FinalErrorMessage = "Error occurred: $ErrorMessage" }