> 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-psuenvironment.md). # New-PSUEnvironment New-PSUEnvironment crée un environnement d'exécution PowerShell dans PowerShell Universal, définissant le runspace, les modules et le script de démarrage. ## SYNOPSIS Crée un environnement d'exécution PowerShell Universal. ## SYNTAXE ```powershell New-PSUEnvironment -Name [-Version ] [-Type ] [-Path ] [-Arguments ] [-Modules ] [-Variables ] [-PSModulePath ] [-StartupScript ] [-PersistentRunspace] [-RunspaceRecycling] [-MaxRunspaces ] [-MaxVirtualMemory ] [-RunspaceSaturationWarningThresholdPercent ] [-RunspaceSaturationWarningDurationSeconds ] [-RecycleSchedule ] [-Credential ] [-Description ] [-DisableImplicitWinCompat] [-Minimal] [-Disabled] [-ProcessStartupScript ] [-EnableDebugger] [-Verb ] [-PowerShellVersion ] [-Virtual] [-ContainerImageUrl ] [-ContainerImageTag ] [-ContainerPull] [] [] ``` ``: `[-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`. Ici, `-Credential` est une variable d'identifiant PSU pour l'exécution, et non un identifiant de l'API de gestion. ## DESCRIPTION Crée un environnement pour les API, les scripts, les applis et les processus de sécurité. `-Type` accepte `Custom`, `WindowsPowerShell`, `PowerShell7`, `Isolated` ou `Container`. Pour `Isolated`, `-PowerShellVersion` accepte une version installée ou un sélecteur multi-pwsh tel que `stable`, `preview`, `lts` ou `7.4` ; `-Virtual` active un environnement virtuel multi-pwsh géré. Les options de conteneur configurent l'URL de l'image, l'étiquette et le téléchargement de l'image. `-EnableDebugger` est conservé pour la compatibilité, mais il n'est plus requis et émet un avertissement. ## EXEMPLE ```powershell New-PSUEnvironment -Name 'Isolated 7.4' -Type Isolated -PowerShellVersion '7.4' -Virtual ``` ## PARAMÈTRES | Paramètre | Description | | -------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `-Name` | Nom d'environnement obligatoire. | | `-Version` | Identificateur de version de l'environnement ; par défaut, son nom. | | `-Type` | Type d'environnement : `Custom`, `WindowsPowerShell`, `PowerShell7`, `Isolated` ou `Container`. | | `-Path` | Chemin de l'exécutable de l'environnement. | | `-Arguments` | Arguments de processus supplémentaires. | | `-Modules` | Modules configurés pour l'environnement. | | `-Variables` | Noms des variables PSU offertes à l'environnement ; la valeur par défaut est `*`. | | `-PSModulePath` | Chemins de modules PowerShell supplémentaires. | | `-StartupScript` | Scripts à exécuter au démarrage des runspaces. | | `-PersistentRunspace` | Active un runspace persistant. | | `-RunspaceRecycling` | Active le recyclage des runspaces. | | `-MaxRunspaces` | Nombre maximal de runspaces (25 par défaut). | | `-MaxVirtualMemory` | Mémoire virtuelle maximale en Mo ; convertie en octets pour le stockage. | | `-RunspaceSaturationWarningThresholdPercent` | Pourcentage du seuil d'avertissement de saturation des runspaces (80 par défaut). | | `-RunspaceSaturationWarningDurationSeconds` | Durée de l'avertissement de saturation, en secondes (30 par défaut). | | `-RecycleSchedule` | Planification du recyclage des runspaces. | | `-Credential` | Variable d'identifiant PSU pour l'exécution, et non un `PSCredential` de l'API de gestion. | | `-Description` | Description de l'environnement. | | `-DisableImplicitWinCompat` | Désactive la compatibilité Windows implicite. | | `-Minimal` | Active un démarrage minimal de l'environnement. | | `-Disabled` | Crée l'environnement à l'état désactivé. | | `-ProcessStartupScript` | Script exécuté au démarrage du processus. | | `-EnableDebugger` | Commutateur de compatibilité hérité ; il ne fait plus qu'émettre un avertissement. | | `-Verb` | Verbe utilisé pour lancer l'exécutable. | | `-PowerShellVersion` | Version de PowerShell installée ou sélecteur multi-pwsh pour les environnements isolés. | | `-Virtual` | Active un environnement virtuel géré. | | `-ContainerImageUrl` | URL de l'image de conteneur. | | `-ContainerImageTag` | Étiquette de l'image de conteneur. | | `-ContainerPull` | Télécharge l'image de conteneur configurée. | | `-ComputerName` | URL ou nom d'hôte du serveur PSU cible (alias `-Uri`). | | `-AppToken` | Jeton d'application de l'API de gestion. | | `-UseDefaultCredentials` | Utilise les identifiants Windows actuels. | | `-Integrated` | Utilise le client de gestion dans le processus. | | `-TrustCertificate` | Ignore les erreurs de validation du certificat. | | `-Cookies` | Réutilise les témoins d'authentification de la session. | ## PERMISSIONS Le jeton d'accès requiert `settings.environments/create` pour exécuter cette applet de commande à distance. --- # 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-psuenvironment.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.