New-PSUEnvironment

SYNOPSIS

Crée un nouvel environnement PowerShell Universal.

SYNTAXE

New-PSUEnvironment -Name <String> [-Version <String>] [-Type <EnvironmentType>] [-Path <String>]
 [-Arguments <String>] [-Modules <String[]>] [-Variables <String[]>] [-PSModulePath <String[]>]
 [-StartupScript <String[]>] [-PersistentRunspace] [-RunspaceRecycling] [-MaxRunspaces <Int32>]
 [-MaxVirtualMemory <Int64>] [-RecycleSchedule <String>] [-Credential <Variable>] [-Description <String>]
 [-DisableImplicitWinCompat] [-Minimal] [-Disabled] [-ProcessStartupScript <String>] [-EnableDebugger]
 [-Verb <String>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated]
 [-TrustCertificate] [-Cookies] [<CommonParameters>]

DESCRIPTION

Les environnements définissent des environnements d'exécution PowerShell au sein de PowerShell Universal. Vous pouvez les utiliser lors de l'exécution d'API, de scripts, de tableaux de bord et des processus de sécurité pour l'authentification et l'autorisation.

Les environnements sont stockés dans le fichier ./universal/environments.ps1.

Vous pouvez également utiliser cette applet de commande pour créer des environnements via l'API REST.

EXEMPLES

Exemple 1

PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe'

Crée un nouvel environnement appelé 7.1 qui utilise pwsh.exe pour exécuter des API, des scripts ou des tableaux de bord.

Exemple 2

PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass"

Crée un nouvel environnement appelé 7.1 qui utilise l'exécutable pwsh.exe et définit la stratégie d'exécution à ByPass.

Exemple 3

PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -Variables @("*")

Crée un nouvel environnement qui utilise toutes les variables définies avec New-PSUVariable.

Exemple 4

PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -Modules @("ActiveDirectory")

Crée un nouvel environnement qui charge automatiquement le module ActiveDirectory.

Exemple 5

PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -PersistentRunspace

Crée un nouvel environnement qui utilise des runspaces persistants. Les runspaces persistants sont utilisés pour les API et ne sont pas réinitialisés entre chaque exécution.

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 afin de définir le AppToken pour toute la session.

Type: String
Parameter Sets: (All)
Aliases:

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

-Arguments

Arguments à passer au processus PowerShell lors du démarrage de l'environnement.

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 de l'ordinateur ou l'URL qui doit être appelé lors de l'accès à l'API de gestion de PowerShell Universal. Vous pouvez également utiliser Connect-PSUServer avant d'appeler cette applet de commande afin de définir le nom de l'ordinateur pour toute la session.

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

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

-Modules

Modules à charger automatiquement lors de la création de nouveaux runspaces dans l'environnement.

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

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

-Name

Le nom de l'environnement.

Type: String
Parameter Sets: (All)
Aliases:

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

-PSModulePath

Chemins supplémentaires à ajouter au PSModulePath pour l'environnement.

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

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

-Path

Le chemin vers l'exécutable PowerShell.

Type: String
Parameter Sets: (All)
Aliases:

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

-PersistentRunspace

Indique s'il faut activer les runspaces persistants. Ceci est utilisé uniquement pour les API.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Variables

Variables à importer dans le runspace. Il s'agit des variables définies par New-PSUVariable.

Type: String[]
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

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 d'un script depuis PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-StartupScript

Un script à exécuter lors de la création des runspaces dans cet environnement.

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

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

-Version

Un numéro de version à afficher.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunspaceRecycling

Indique s'il faut recycler les runspaces. Les runspaces seront recyclés (supprimés et recréés) après un certain temps ou un certain nombre d'utilisations.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-MaxRunspaces

Le nombre maximal de runspaces à créer pour cet environnement.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-EnableDebugger

Active la fonctionnalité de débogage PowerShell pour cet environnement.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

L'identifiant à utiliser avec cet environnement

Type: Variable
Parameter Sets: (All)
Aliases:

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

-MaxVirtualMemory

La mémoire virtuelle maximale en octets. Lorsque le seuil est atteint, le processus est redémarré. Ignoré pour l'environnement intégré.

Type: Int64
Parameter Sets: (All)
Aliases:

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

-RecycleSchedule

Un horaire CRON pour redémarrer cet environnement. Ignoré pour l'environnement intégré.

Type: String
Parameter Sets: (All)
Aliases:

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

-Description

Une description pour cet environnement.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableImplicitWinCompat

Désactive le mode de compatibilité implicite de Windows PowerShell.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Minimal

Un environnement minimal qui ne charge aucun module ni aucune variable.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProcessStartupScript

Un script qui s'exécute une seule fois au démarrage du processus. Il n'est pas exécuté pour chaque runspace.

Type: String
Parameter Sets: (All)
Aliases:

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

-Disabled

L'environnement est désactivé.

Type: SwitchParameter
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.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Type

Le type d'environnement. PowerShell 7 et Windows PowerShell 5.1 sont pris en charge. Utilisez Custom pour créer un environnement personnalisé

Type: EnvironmentType
Parameter Sets: (All)
Aliases:

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

-Verb

Le verbe à utiliser lors de la création du processus pour cet environnement. Ceci n'est pas utilisé pour l'environnement intégré.

Type: String
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.

Type: SwitchParameter
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.

ENTRÉES

Aucune

SORTIES

System.Object

NOTES

LIENS CONNEXES

New-PSUVariable