> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/da/powershell-kommandoer/new-udcheckbox.md). # New-UDCheckBox New-UDCheckBox opretter et afkrydsningsfelt i PowerShell Universal til registrering af boolesk input, der kan bruges enkeltstående eller inde i New-UDForm. ### Synopsis Opretter et afkrydsningsfelt. ### Syntaks ```powershell New-UDCheckBox [[-Label] ] [[-Icon] ] [[-CheckedIcon] ] [[-OnChange] ] [[-Style] ] [[-Disabled]] [[-Checked] ] [[-ClassName] ] [[-LabelPlacement] ] [[-Id] ] [[-Size] ] [-Color ] [-Indeterminate] [-Aria ] [] ``` ### Beskrivelse Opretter et afkrydsningsfelt. Afkrydsningsfelter kan bruges i formularer eller for sig selv. ### Parametre #### -Label Den etiket, der skal vises ved siden af afkrydsningsfeltet. ``` Required? false Position? 1 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon Det ikon, der skal vises i stedet for standardikonet. Brug New-UDIcon til at oprette et ikon. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -CheckedIcon Det ikon, der skal vises i stedet for det markerede standardikon. Brug New-UDIcon til at oprette et ikon. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnChange Kaldes, når værdien af afkrydsningsfeltet ændres. Variablen $EventData vil indeholde den aktuelle værdi af afkrydsningsfeltet. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style En hashtable med typografier, der skal anvendes på afkrydsningsfeltet. ``` Required? false Position? 5 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Om afkrydsningsfeltet er deaktiveret. ``` Required? false Position? 6 Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Checked Om afkrydsningsfeltet er markeret. ``` Required? false Position? 7 Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName En CSS-klasse, der skal tildeles afkrydsningsfeltet. ``` Required? false Position? 8 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -LabelPlacement Hvor etiketten skal placeres. Gyldige værdier er: "top","start","bottom","end" ``` Required? false Position? 8 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Id Id for komponenten. Standardværdien er et tilfældigt GUID. ``` Required? false Position? 9 Default value ([Guid]::NewGuid()).ToString() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Size Størrelsen på afkrydsningsfeltet. Gyldige værdier er: "small", "medium" ``` Required? false Position? 10 Default value medium Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color Den temafarve, der skal anvendes på denne komponent ``` Required? false Position? named Default value default Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Indeterminate Om afkrydsningsfeltet er i en ubestemt tilstand. Dette er kun en visuel tilstand og påvirker ikke værdien af afkrydsningsfeltet. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Aria En scriptblok med kald til `New-UDAriaAttribute`, der leverer ARIA- eller rolleattributter til afkrydsningsfeltet. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Fælles parametre Denne cmdlet understøtter de fælles parametre: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable og OutVariable. Se [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216) for at få flere oplysninger. ### Output ### Eksempler #### Eksempel 1: grundlæggende afkrydsningsfelt ```powershell New-UDCheckbox -Label 'Demo' -Id 'checkbox1' ``` Et grundlæggende afkrydsningsfelt. #### Eksempel 2: deaktiveret afkrydsningsfelt ```powershell New-UDCheckbox -Label 'Demo' -Disabled -Id 'checkbox2' ``` Et deaktiveret afkrydsningsfelt. #### Eksempel 3: afkrydset afkrydsningsfelt ```powershell New-UDCheckbox -Label 'Demo' -Checked $true -Id 'checkbox3' ``` Et afkrydset afkrydsningsfelt. #### Eksempel 4: afkrydsningsfelt med brugerdefinerede ikoner ```powershell New-UDCheckbox -Label 'Demo' -Icon (New-UDIcon -Icon 'user') -CheckedIcon (New-UDIcon -Icon 'check') -Id 'checkbox4' ``` Et afkrydsningsfelt med brugerdefinerede ikoner. #### Eksempel 5: afkrydsningsfelt med OnChange ```powershell New-UDCheckbox -Label 'Demo' -OnChange { Show-UDToast -Title 'Checkbox' -Message $Body } -Id 'checkbox5' ``` Et afkrydsningsfelt med en OnChange-hændelse. #### Eksempel 6: afkrydsningsfelt med etiket øverst ```powershell New-UDCheckbox -Label 'Demo' -LabelPlacement 'top' -Id 'checkbox6' ``` Et afkrydsningsfelt med etiketten øverst. #### Eksempel 7: afkrydsningsfelt med sekundær farve ```powershell New-UDCheckbox -Label 'Demo' -Color 'secondary' -Id 'checkbox7' ``` Et afkrydsningsfelt med den sekundære farve. #### Eksempel 8: afkrydsningsfelt i ubestemt tilstand ```powershell New-UDCheckbox -Label 'Demo' -Id 'checkbox8' -Indeterminate ``` Et afkrydsningsfelt i en ubestemt tilstand. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.devolutions.net/powershell-universal/da/powershell-kommandoer/new-udcheckbox.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.