> 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] ] [[-OnUploadProgress] ] [[-Text] ] [[-Variant] ] [[-Color] ] [[-ClassName] ] [-HideUploadedFileName] [-Multiple] [-ShowLoading] [[-LoadingIndicator] ] [[-LoadingPosition] ] [[-Icon] ] [[-IconAlignment] ] [[-Style] ] [[-Aria] ] [] ``` ### 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 ``` #### -OnUploadProgress Un endpoint chiamato quando cambia lo stato di avanzamento del caricamento. `$EventData` contiene `fileName`, `fileIndex`, `fileCount`, `fileProgress`, `totalProgress`, `bytesUploaded`, `totalBytes`, `fileSize` e `uploadedFileSize`. ``` Required? false Position? named 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 ``` #### -Multiple Consente di selezionare e caricare più file. Con questo commutatore, il gestore `-OnUpload` riceve una matrice di oggetti di caricamento in `$EventData`. ``` 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 ``` #### -Style Una hashtable di stili CSS applicati al componente di caricamento. ``` Required? false Position? named Default value Accept pipeline input? false Aliases Accept wildcard characters? false ``` #### -Aria Un blocco di script di chiamate a `New-UDAriaAttribute` che fornisce attributi ARIA o di ruolo per il controllo di caricamento. ``` Required? false Position? named Default value 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: 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 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/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 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.