Spring til indhold
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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)

$Test

Parametertyper

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?