> 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/fr/commandes-powershell/new-udupload.md).

# New-UDUpload

New-UDUpload ajoute un contrôle de téléversement de fichiers à PowerShell Universal, fonctionnant de pair avec les composants New-UDForm et New-UDStepper.

### Synopsis

Téléverser des fichiers

### Syntaxe

```powershell
New-UDUpload [[-Id] <String>] [[-Accept] <String>] [[-OnUpload] <Endpoint>] [[-OnUploadProgress] <Endpoint>] [[-Text] <String>] [[-Variant] <String>] [[-Color] <String>] [[-ClassName] <String>] [-HideUploadedFileName] [-Multiple] [-ShowLoading] [[-LoadingIndicator] <Object>] [[-LoadingPosition] <String>] [[-Icon] <Object>] [[-IconAlignment] <String>] [[-Style] <Hashtable>] [[-Aria] <ScriptBlock>] [<CommonParameters>]
```

### Description

Téléverser des fichiers. Ce composant fonctionne avec UDForm et UDStepper.

### Paramètres

#### -Id

L'ID du téléverseur.

```
Required?                    false
Position?                    1
Default value                [Guid]::NewGuid()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Accept

Le type de fichiers à accepter. Par défaut, ce composant accepte tous les fichiers.

```
Required?                    false
Position?                    2
Default value                *
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -OnUpload

Un bloc de script à exécuter lorsqu'un fichier est téléversé. Ce paramètre $body contiendra du JSON dans le format suivant :

{ data: 'base64 encoded string of file data', name: 'filename', type: 'type of file, if known' }

$EventData contiendra une classe avec les propriétés suivantes :

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 point de terminaison appelé lorsque la progression du téléversement change. `$EventData` contient `fileName`, `fileIndex`, `fileCount`, `fileProgress`, `totalProgress`, `bytesUploaded`, `totalBytes`, `fileSize` et `uploadedFileSize`.

```
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Text

Le texte à afficher sur le bouton de téléversement.

```
Required?                    false
Position?                    4
Default value                Upload
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Variant

La variante du bouton. La valeur par défaut est contained. Valeurs valides : "text", "outlined", "contained"

```
Required?                    false
Position?                    5
Default value                contained
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Color

La couleur du bouton. La valeur par défaut est 'default'. Valeurs valides : "default", "primary", "secondary", "inherit"

```
Required?                    false
Position?                    6
Default value                primary
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -ClassName

Une classe CSS à appliquer au bouton.

```
Required?                    false
Position?                    7
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -HideUploadedFileName

Masque le texte du nom de fichier qui est affiché après le téléversement

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Multiple

Autorise la sélection et le téléversement de plusieurs fichiers. Avec ce commutateur, le gestionnaire `-OnUpload` reçoit un tableau d'objets de téléversement dans `$EventData`.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -ShowLoading

Affiche un indicateur de chargement pendant l'exécution du gestionnaire d'événement OnClick.

```
Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -LoadingIndicator

Un élément personnalisé à afficher au lieu de l'indicateur intégré pour -ShowLoading

```
Required?                    false
Position?                    8
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -LoadingPosition

La position de l'indicateur de chargement. Les valeurs valides sont : 'start', 'end', 'center'

```
Required?                    false
Position?                    9
Default value                center
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Icon

L'icône à afficher au lieu de l'icône par défaut. Utilisez New-UDIcon pour créer une icône.

```
Required?                    false
Position?                    10
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -IconAlignment

Comment aligner l'icône dans le bouton. Les valeurs valides sont : "left", "right"

```
Required?                    false
Position?                    11
Default value                left
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Style

Une table de hachage de styles CSS appliqués au composant de téléversement.

```
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### -Aria

Un bloc de script d'appels `New-UDAriaAttribute` qui fournit les attributs ARIA ou de rôle du contrôle de téléversement.

```
Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false
```

#### Paramètres communs

Cette applet de commande prend en charge les paramètres communs : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable. Pour plus d'informations, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

### Sorties

### Exemples

#### Exemple 1 : Téléversement de base

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload1'
```

Un composant de téléversement de base qui affiche une notification lorsqu'un fichier est téléversé.

#### Exemple 2 : Masquer le nom de fichier

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload2' -HideUploadedFileName
```

Masque le texte du nom de fichier qui est affiché après le téléversement.

#### Exemple 3 : Icône

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload3' -Icon (New-UDIcon -Icon 'Upload')
```

Composant de téléversement avec une icône au lieu de l'icône par défaut.

#### Exemple 4 : Alignement de l'icône

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload4' -IconAlignment 'right' -Icon (New-UDIcon -Icon 'Upload')
```

Composant de téléversement avec une icône du côté droit du bouton.

#### Exemple 5 : Variante

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload5' -Variant 'text'
```

Composant de téléversement avec une variante text.

#### Exemple 6 : Accept

```powershell
New-UDUpload -Text "Upload" -OnUpload {
    Show-UDToast $Body
} -Id 'upload6' -Accept ".jpg"
```

Composant de téléversement qui accepte uniquement les fichiers .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/fr/commandes-powershell/new-udupload.md?ask=<question>&goal=<user_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.