> 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-udbutton.md). # New-UDButton New-UDButton crea un componente pulsante cliccabile in PowerShell Universal che attiva un'azione, uno script o la navigazione tramite collegamento. ### Sinossi I pulsanti consentono agli utenti di eseguire azioni e fare scelte con un solo tocco.. ### Sintassi ```powershell New-UDButton [[-Text] ] [[-Icon] ] [[-Variant] ] [[-IconAlignment] ] [[-FullWidth]] [[-OnClick] ] [[-Size] ] [[-Style] ] [[-Href] ] [-Target ] [-Id ] [-Color ] [-Disabled] [-ClassName ] [-ShowLoading] [-LoadingIndicator ] [-LoadingPosition ] [] ``` ### Descrizione Crea un nuovo pulsante. I pulsanti consentono agli utenti di eseguire azioni e fare scelte con un solo tocco. ### Parametri #### -Text Il testo da mostrare all'interno del pulsante. ``` Required? false Position? 1 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Icon Un'icona da mostrare all'interno del pulsante. Usi New-UDIcon per creare un'icona per questo parametro. ``` Required? false Position? 2 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant Il tipo di variante per questo pulsante. I valori validi sono: "text", "outlined", "contained" ``` Required? false Position? 3 Default value contained Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -IconAlignment Come allineare l'icona all'interno del pulsante. I valori validi sono: "left", "right" ``` Required? false Position? 4 Default value left Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -FullWidth Indica se il pulsante occupa l'intera larghezza del suo contenitore. ``` Required? false Position? 7 Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnClick L'azione da eseguire quando si fa clic sul pulsante. ``` Required? false Position? 8 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Size La dimensione del pulsante. I valori validi sono: "small", "medium", "large" ``` Required? false Position? 9 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Style Stili da applicare al pulsante. ``` Required? false Position? 10 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Href Un URL a cui l'utente deve essere reindirizzato quando fa clic sul pulsante. ``` Required? false Position? 11 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Target ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Id L'ID del componente. Per impostazione predefinita è un GUID casuale. ``` Required? false Position? named Default value ([Guid]::NewGuid()).ToString() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color Il colore del componente. I valori validi sono: 'default', 'inherit', 'primary', 'secondary', 'info', 'warning', 'error', 'success' ``` Required? false Position? named Default value primary Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Disabled Indica se il pulsante è disabilitato. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName La classe CSS da applicare al pulsante. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ShowLoading Visualizza un indicatore di caricamento mentre il gestore dell'evento OnClick è in esecuzione. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -LoadingIndicator Un elemento personalizzato da visualizzare al posto dell'indicatore integrato per -ShowLoading ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -LoadingPosition La posizione dell'indicatore di caricamento. I valori validi sono: 'start', 'end', 'center' ``` Required? false Position? named Default value center 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: pulsanti di base ```powershell New-UDButton -Variant 'text' -Text 'Text' -Id 'button1' New-UDButton -Variant 'contained' -Text 'Contained' -Id 'button2' New-UDButton -Variant 'outlined' -Text 'Outlined' -Id 'button3' ``` UDButton è disponibile in tre varianti: text, contained e outlined. #### Esempio 2: gestione dei clic ```powershell New-UDButton -Text 'Click me' -OnClick { Show-UDToast -Message 'Hello, world!' } -Id 'button4' ``` PowerShell eseguito quando si fa clic sul pulsante. #### Esempio 3: colore ```powershell New-UDButton -Text 'Secondary' -Color secondary -Id 'button5' New-UDButton -Text 'Success' -Color success -Id 'button6' New-UDButton -Text 'Error' -Color error -Id 'button7' ``` Regoli il colore del pulsante con -Color #### Esempio 4: dimensioni ```powershell New-UDButton -Variant 'text' -Text 'small' -Id 'button8' -Size small New-UDButton -Variant 'text' -Text 'medium' -Id 'button9' -Size medium New-UDButton -Variant 'text' -Text 'large' -Id 'button10' -Size large New-UDButton -Variant 'contained' -Text 'small' -Id 'button11' -Size small New-UDButton -Variant 'contained' -Text 'medium' -Id 'button12' -Size medium New-UDButton -Variant 'contained' -Text 'large' -Id 'button13' -Size large New-UDButton -Variant 'outlined' -Text 'small' -Id 'button14' -Size small New-UDButton -Variant 'outlined' -Text 'medium' -Id 'button15' -Size medium New-UDButton -Variant 'outlined' -Text 'large' -Id 'button16' -Size large ``` Per pulsanti più grandi o più piccoli, usi il parametro -Size. #### Esempio 5: icona ```powershell New-UDButton -Icon (New-UDIcon -Icon 'User') -Text 'View User' -Id 'button17' ``` Visualizzare un'icona all'interno del pulsante #### Esempio 6: caricamento ```powershell New-UDButton -OnClick { Start-Sleep 3 } -ShowLoading -Text 'Load Data' -Id 'button18' ``` Mostra un indicatore di caricamento mentre il gestore dell'evento OnClick è in esecuzione. --- # 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-udbutton.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.