> 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-udupload.md). # New-UDUpload New-UDUpload aggiunge un controllo di caricamento file a PowerShell Universal, funzionando insieme ai componenti New-UDForm e New-UDStepper. ### Sinossi Caricare file ### Sintassi ```powershell New-UDUpload [[-Id] ] [[-Accept] ] [[-OnUpload] ] [[-Text] ] [[-Variant] ] [[-Color] ] [[-ClassName] ] [-HideUploadedFileName] [-ShowLoading] [[-LoadingIndicator] ] [[-LoadingPosition] ] [[-Icon] ] [[-IconAlignment] ] [] ``` ### Descrizione Caricare file. Questo componente funziona con UDForm e UDStepper. ### Parametri #### -Id L'ID dell'uploader. ``` Required? false Position? 1 Default value [Guid]::NewGuid() Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Accept Il tipo di file da accettare. Per impostazione predefinita, questo componente accetta tutti i file. ``` Required? false Position? 2 Default value * Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -OnUpload Uno script block da eseguire quando viene caricato un file. Questo parametro $body conterrà JSON nel formato seguente: { data: 'base64 encoded string of file data', name: 'filename', type: 'type of file, if known' } $EventData conterrà una classe con le seguenti proprietà: public string Name { get; set; } public string FileName { get; set; } public DateTime TimeStamp { get; set; } public string ContentType { get; set; } public string Type => ContentType; ``` Required? false Position? 3 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Text Il testo da visualizzare sul pulsante di caricamento. ``` Required? false Position? 4 Default value Upload Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Variant La variante del pulsante. Il valore predefinito è contained. Valori validi: "text", "outlined", "contained" ``` Required? false Position? 5 Default value contained Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Color Il colore del pulsante. Il valore predefinito è 'default'. Valori validi: "default", "primary", "secondary", "inherit" ``` Required? false Position? 6 Default value primary Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ClassName Una classe CSS da applicare al pulsante. ``` Required? false Position? 7 Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -HideUploadedFileName Nasconde il testo del nome file mostrato dopo il caricamento ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -ShowLoading Visualizza uno spinner di caricamento mentre è in esecuzione il gestore dell'evento OnClick. ``` Required? false Position? named Default value False Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -LoadingIndicator Un elemento personalizzato da visualizzare al posto dello spinner integrato per -ShowLoading ``` Required? false Position? 8 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? 9 Default value center 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? 10 Default value 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? 11 Default value left 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, consulti [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Output ### Esempi #### Esempio 1: caricamento di base ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload1' ``` Un componente di caricamento di base che mostra un toast quando un file viene caricato. #### Esempio 2: nascondere il nome del file ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload2' -HideUploadedFileName ``` Nasconde il testo del nome file mostrato dopo il caricamento. #### Esempio 3: icona ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload3' -Icon (New-UDIcon -Icon 'Upload') ``` Componente di caricamento con un'icona al posto dell'icona predefinita. #### Esempio 4: allineamento dell'icona ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload4' -IconAlignment 'right' -Icon (New-UDIcon -Icon 'Upload') ``` Componente di caricamento con un'icona sul lato destro del pulsante. #### Esempio 5: variante ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload5' -Variant 'text' ``` Componente di caricamento con una variante di testo. #### Esempio 6: accept ```powershell New-UDUpload -Text "Upload" -OnUpload { Show-UDToast $Body } -Id 'upload6' -Accept ".jpg" ``` Componente di caricamento che accetta solo file .jpg. --- # 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-udupload.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.