> 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-psuscript.md).

# New-PSUScript

New-PSUScript crée une nouvelle ressource de script dans PowerShell Universal, en définissant ses paramètres, son environnement, son comportement de planification et son affichage dans le portail.

## SYNOPSIS

Crée un nouveau script dans PowerShell Universal.

## SYNTAXE

### ScriptBlock

```
New-PSUScript -ScriptBlock <ScriptBlock> [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String>
 [-Description <String>] [-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>]
 [-Environment <String>] [-Notes <String>] [-DisableManualInvocation] [-Path <String>] [-MaxHistory <Int32>]
 [-ConcurrentJobs <Int32>] [-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile]
 [-WorkingDirectory <String>] [-Role <String[]>] [-PortalOutputType <PortalOutputType>]
 [-AvailableInBranch <String[]>] [-PortalOpenInNewWindow] [-Icon <String>]
 [-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm] [-DisplayOutputOnExecute]
 [-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]
```

### Path

```
New-PSUScript [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String> [-Description <String>]
 [-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>] [-Environment <String>]
 [-Notes <String>] [-DisableManualInvocation] -Path <String> [-MaxHistory <Int32>] [-ConcurrentJobs <Int32>]
 [-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory <String>]
 [-Role <String[]>] [-PortalOutputType <PortalOutputType>] [-AvailableInBranch <String[]>]
 [-PortalOpenInNewWindow] [-Icon <String>] [-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm]
 [-DisplayOutputOnExecute] [-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]
```

### Module

```
New-PSUScript [-ManualTime <Int32>] [-TimeOut <Double>] [-Description <String>]
 [-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>] [-Environment <String>]
 [-Notes <String>] [-DisableManualInvocation] [-MaxHistory <Int32>] [-ConcurrentJobs <Int32>]
 [-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory <String>]
 -Module <String> -Command <String> [-Role <String[]>] [-PortalOutputType <PortalOutputType>]
 [-AvailableInBranch <String[]>] [-PortalOpenInNewWindow] [-Icon <String>]
 [-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm] [-DisplayOutputOnExecute]
 [-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]
```

## DESCRIPTION

Crée un nouveau script dans PowerShell Universal. Les scripts peuvent être exécutés manuellement ou planifiés dans PSU. Les scripts créés en fonction du contenu seront écrits dans le répertoire du dépôt. Les scripts créés par chemin seront référencés par ce chemin.

Les configurations de script sont stockées dans .universal/scripts.ps1

Vous pouvez également utiliser cette applet de commande pour créer des scripts par l'intermédiaire de l'API REST.

## EXEMPLES

### Exemple 1

```
New-PSUScript -Name 'Script1.ps1' -Path 'Script1.ps1'
```

Crée un script dans PSU qui référence un chemin relatif de Script1.ps1 dans le dossier du dépôt.

### Exemple 2

```
New-PSUScript -Name 'Script1.ps1' -ScriptBlock {
    "Hello, world!"
}
```

Crée un script dans PSU en fonction du bloc de script fourni. Cela créera un fichier Script1.ps1 dans le répertoire du dépôt.

## PARAMÈTRES

### -AppToken

Le AppToken utilisé pour appeler l'API de gestion de PowerShell Universal. Vous pouvez également appeler Connect-PSUServer avant d'appeler cette applet de commande pour définir le AppToken pour toute la session.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ComputerName

Spécifie le nom d'ordinateur ou l'URL qui doit être appelé lors de l'accès à l'API de gestion de PowerShell Universal. Vous pouvez aussi utiliser Connect-PSUServer avant d'appeler cette applet de commande pour définir le nom d'ordinateur pour toute la session.

```yaml
Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

La description du script.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DisableManualInvocation

Désactive l'invocation manuelle du script. Le script ne peut être exécuté que selon une planification.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
```

### -ManualTime

Le temps qu'il faudrait pour exécuter ce script en particulier manuellement.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MaxHistory

L'historique maximal des tâches pour ce script. La valeur par défaut est 100.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Name

Le nom de ce script.

```yaml
Type: String
Parameter Sets: ScriptBlock, Path
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Notes

Notes à inclure avec ce script.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Parameter

Obsolète

```yaml
Type: ScriptParameter[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Path

Le chemin vers le script. Il peut s'agir d'un chemin relatif au répertoire du dépôt ou d'un chemin absolu.

```yaml
Type: String
Parameter Sets: ScriptBlock
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

```yaml
Type: String
Parameter Sets: Path
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ScriptBlock

Un bloc de script à définir pour ce script.

```yaml
Type: ScriptBlock
Parameter Sets: ScriptBlock
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Status

Non utilisé.

```yaml
Type: ScriptStatus
Parameter Sets: (All)
Aliases:
Accepted values: Draft, Pending_Review, Published, Disabled

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Tag

Étiquettes à attribuer à ce script.

```yaml
Type: Tag[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ConcurrentJobs

Le nombre de tâches simultanées autorisées pour ce script. Par défaut, il n'y a aucune limite.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Environment

L'environnement dans lequel exécuter ce script.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TimeOut

Le nombre de minutes avant l'expiration des tâches basées sur ce script.

```yaml
Type: Double
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Credential

La variable d'identifiant utilisateur à utiliser lors de l'exécution de ce script.

```yaml
Type: Variable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -UseDefaultCredentials

Utiliser les identifiants par défaut lors de la connexion à l'API de gestion

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Integrated

Exécute la commande en interne plutôt qu'en utilisant l'API de gestion. Fonctionne uniquement lors de l'exécution du script depuis PowerShell Universal.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RetryLimit

Le nombre de fois qu'il faut réessayer ce script s'il échoue.

```yaml
Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DiscardPipeline

Indique s'il faut ignorer la sortie du pipeline plutôt que de la conserver dans la base de données.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -LoadProfile

Charge le profil utilisateur lors de l'exécution de ce script en tant qu'autre utilisateur.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -WorkingDirectory

Le répertoire de travail du script.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Command

La commande qui définit ce script.

```yaml
Type: String
Parameter Sets: Module
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Module

Le module qui contient la commande qui définit ce script.

```yaml
Type: String
Parameter Sets: Module
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Role

Le rôle requis pour exécuter ce script.

```yaml
Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -AvailableInBranch

Lorsque spécifié, ce script sera disponible uniquement dans les branches spécifiées.

```yaml
Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PortalOutputType

Le type de sortie du portail à afficher lors de l'exécution de ce script dans le portail.

```yaml
Type: PortalOutputType
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -TrustCertificate

Indique si l'applet de commande doit ignorer les problèmes de certificat.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PortalOpenInNewWindow

Indique s'il faut ouvrir ce script dans une nouvelle fenêtre lors de sa consultation dans le portail.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Icon

Une icône à afficher dans le portail.

```yaml
Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -DisplayOutputOnExecute

Affiche la sortie du script pendant son exécution dans le portail.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PortalBehavior

Comment ce script se comporte dans le portail.

```yaml
Type: ScriptPortalBehavior
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -PortalLeaveForm

Indique s'il faut quitter le formulaire du script après son exécution dans le portail.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Cookies

Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -ExecutionRole

Spécifie un ou plusieurs rôles qui peuvent exécuter la ressource.

```yaml
Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

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

## ENTRÉES

### Aucune

## SORTIES

### System.Object

## NOTES

## LIENS CONNEXES

[Get-PSUScript](https://github.com/Devolutions/doc-gitbook/tree/master/translations/fr/powershell-universal/cmdlets/Get-PSUScript/README.md) [Remove-PSUScript](https://github.com/Devolutions/doc-gitbook/tree/master/translations/fr/powershell-universal/cmdlets/Remove-PSUScript/README.md) [Invoke-PSUScript](https://github.com/Devolutions/doc-gitbook/tree/master/translations/fr/powershell-universal/cmdlets/Invoke-PSUScript/README.md) [Set-PSUScript](https://github.com/Devolutions/doc-gitbook/tree/master/translations/fr/powershell-universal/cmdlets/Set-PSUScript/README.md) [Get-PSUEnvironment](https://github.com/Devolutions/doc-gitbook/tree/master/translations/fr/powershell-universal/cmdlets/Get-PSUEnvironment/README.md)


---

# 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/fr/commandes-powershell/new-psuscript.md?ask=<question>&goal=<endgoal>
```

`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.