> 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/it/comandi-powershell/new-udcheckbox.md). # New-UDCheckBox New-UDCheckBox crea un controllo casella di controllo in PowerShell Universal per acquisire un input booleano, utilizzabile da solo o all'interno di New-UDForm. ### Sinossi Crea una casella di controllo. ### Sintassi ```powershell New-UDCheckBox [[-Label] ] [[-Icon] ] [[-CheckedIcon] ] [[-OnChange] ] [[-Style] ] [[-Disabled]] [[-Checked] ] [[-ClassName] ] [[-LabelPlacement] ] [[-Id] ] [[-Size] ] [-Color ] [-Indeterminate] [] ``` ### Descrizione Crea una casella di controllo. Le caselle di controllo possono essere usate nei moduli o da sole. ### Parametri #### -Label L'etichetta da mostrare accanto alla casella di controllo. ``` Required? false Position? 1 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon L'icona da mostrare al posto dell'icona predefinita. Usi New-UDIcon per creare un'icona. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -CheckedIcon L'icona da mostrare al posto dell'icona predefinita di selezione. Usi New-UDIcon per creare un'icona. ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnChange Chiamato quando il valore della casella di controllo cambia. La variabile $EventData conterrà il valore corrente della casella di controllo. ``` Required? false Position? 4 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style Una hashtable di stili da applicare alla casella di controllo. ``` Required? false Position? 5 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Se la casella di controllo è disabilitata. ``` Required? false Position? 6 Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Checked Se la casella di controllo è selezionata. ``` Required? false Position? 7 Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Una classe CSS da assegnare alla casella di controllo. ``` Required? false Position? 8 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -LabelPlacement Dove posizionare l'etichetta. I valori validi sono: "top","start","bottom","end" ``` Required? false Position? 8 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Id L'ID del componente. Il valore predefinito è un GUID casuale. ``` Required? false Position? 9 Default value ([Guid]::NewGuid()).ToString() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Size La dimensione della casella di controllo. I valori validi sono: "small", "medium" ``` Required? false Position? 10 Default value medium Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color Il colore del tema da applicare a questo componente ``` Required? false Position? named Default value default Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Indeterminate Se la casella di controllo è in uno stato indeterminato. Si tratta solo di uno stato visivo e non influisce sul valore della casella di controllo. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### Parametri comuni Questo cmdlet supporta i parametri comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per maggiori informazioni, veda [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Output ### Esempi #### Esempio 1: casella di controllo di base ```powershell New-UDCheckbox -Label 'Demo' -Id 'checkbox1' ``` Una casella di controllo di base. #### Esempio 2: casella di controllo disabilitata ```powershell New-UDCheckbox -Label 'Demo' -Disabled -Id 'checkbox2' ``` Una casella di controllo disabilitata. #### Esempio 3: casella di controllo selezionata ```powershell New-UDCheckbox -Label 'Demo' -Checked $true -Id 'checkbox3' ``` Una casella di controllo selezionata. #### Esempio 4: casella di controllo con icone personalizzate ```powershell New-UDCheckbox -Label 'Demo' -Icon (New-UDIcon -Icon 'user') -CheckedIcon (New-UDIcon -Icon 'check') -Id 'checkbox4' ``` Una casella di controllo con icone personalizzate. #### Esempio 5: casella di controllo con OnChange ```powershell New-UDCheckbox -Label 'Demo' -OnChange { Show-UDToast -Title 'Checkbox' -Message $Body } -Id 'checkbox5' ``` Una casella di controllo con un evento OnChange. #### Esempio 6: casella di controllo con etichetta in alto ```powershell New-UDCheckbox -Label 'Demo' -LabelPlacement 'top' -Id 'checkbox6' ``` Una casella di controllo con l'etichetta in alto. #### Esempio 7: casella di controllo con colore secondario ```powershell New-UDCheckbox -Label 'Demo' -Color 'secondary' -Id 'checkbox7' ``` Una casella di controllo con il colore secondario. #### Esempio 8: casella di controllo in stato indeterminato ```powershell New-UDCheckbox -Label 'Demo' -Id 'checkbox8' -Indeterminate ``` Una casella di controllo in stato indeterminato. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/it/comandi-powershell/new-udcheckbox.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.