Parametre
Parametre
Jobs understøtter automatisk generering af formularer med parametre baseret på param-blokken i Deres script. Typen af kontrolelement ændres ud fra den type, De definerer i blokken. Parametre, der er obligatoriske, er også påkrævede i brugergrænsefladen.
Grundlæggende parametre
Parametre kan defineres enkelt uden nogen form for parameterattribut, og de vises som tekstfelter i brugergrænsefladen.
param($Test)
$TestParametertyper
Universal understøtter forskellige typer parametre. De kan bruge typerne String, String[], Int, DateTime, Boolean, Switch og Enum.
String
De kan definere strengparametre ved at angive typen [String] eller ved slet ikke at angive en type. Strenge genererer et tekstfelt.
param(
[String]$Textbox,
$Textbox2
)Strengarrays
De kan angive strengarrays ved hjælp af typespecifikationen [String[]]. Strengarrays genererer en valgboks med flere mærker.
Dato og klokkeslæt
De kan bruge typebetegneren [DateTime] til at oprette en dato- og klokkeslætsvælger.
Boolean
De kan bruge en [Bool]-typevælger til at oprette en switch.
Integer
De kan definere en talvælger ved at bruge typeangivelsen [Int].
Switch-parameter
De kan definere en switch-parameter ved hjælp af typespecifikationen [Switch] for at oprette en switch.
Enumerationer
De kan bruge System.Enum-værdier til at oprette valgbokse. De kan f.eks. bruge System.DayOrWeek til at oprette en valgboks for ugedag.
PSCredential
Når De angiver en PSCredential , får brugeren vist en rulleliste over legitimationsoplysninger, der er tilgængelige som variabler.
Fil
De kan give brugere mulighed for at uploade filer ved at bruge typen [File].
Filer vil være tilgængelige som et PSUFile-objekt i Deres scripts. Dette objekt har et byte[]-array, som De kan bruge til at behandle filen.
For eksempel kan De hente strengindholdet for filen ved at konvertere den ved hjælp af Encoding-klasserne.
Visningsnavn
De kan bruge DisplayNameAtrribute til at angive et visningsnavn for scriptparameteren.
Hjælpemeddelelser
De kan definere hjælpemeddelelser til Deres parametre ved hjælp af egenskaben HelpMessage på attributten Parameter.
Påkrævede parametre
De kan bruge attributten Parameter til at definere påkrævede parametre.
Standardværdi
De kan bruge både statiske værdier og standardværdier for parametre. Standardværdien beregnes, når jobbet skal til at køre.
ValidateSet
Attributten ValidateSet bruges til at håndhæve, hvilke værdier der kan sendes til en parameter. Læs om ValidateSet her. PowerShell Universal opretter automatisk en rullemenu med de værdier, der er angivet til attributten ValidateSet for parametre.
Et script kunne for eksempel definere en param-blok som følger.
Overførsel af parametre fra PowerShell
De kan sende parametre fra PowerShell ved hjælp af cmdletten Invoke-PSUScript. Denne cmdlet understøtter dynamiske parametre. Hvis De har en param-blok i Deres script, tilføjes disse parametre automatisk til Invoke-PSUScript.
For eksempel havde jeg et script med navnet Script1.ps1, og indholdet var som følger.
Jeg kunne derefter kalde det script ved hjælp af denne syntaks.
Resultatet ville være, at Hello blev udskrevet i jobloggen og pipelinen.
Parametersæt
PowerShell Universal understøtter parametersæt. Når et parametersæt er defineret, vises en rulleliste, der gør det muligt at skifte mellem sættene.
Sidst opdateret
Var dette nyttigt?