New-PSUEnvironment

ÜBERSICHT

Erstellt eine neue PowerShell Universal-Umgebung.

SYNTAX

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>]

BESCHREIBUNG

Umgebungen definieren PowerShell-Ausführungsumgebungen innerhalb von PowerShell Universal. Sie können sie beim Ausführen von APIs, Skripten, Dashboards sowie für die Sicherheitsprozesse zur Authentifizierung und Autorisierung verwenden.

Umgebungen werden in der Datei ./universal/environments.ps1 gespeichert.

Sie können dieses Cmdlet auch verwenden, um Umgebungen über die REST-API zu erstellen.

BEISPIELE

Beispiel 1

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

Erstellt eine neue Umgebung mit dem Namen 7.1, die pwsh.exe für die Ausführung von APIs, Skripten oder Dashboards verwendet.

Beispiel 2

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

Erstellt eine neue Umgebung mit dem Namen 7.1, die die ausführbare Programmdatei pwsh.exe verwendet und die Ausführungsrichtlinie auf ByPass setzt.

Beispiel 3

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

Erstellt eine neue Umgebung, die alle mit New-PSUVariable definierten Variablen verwendet.

Beispiel 4

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

Erstellt eine neue Umgebung, die das Modul ActiveDirectory automatisch lädt.

Beispiel 5

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

Erstellt eine neue Umgebung, die persistente Runspaces verwendet. Persistente Runspaces werden für APIs verwendet und werden zwischen den einzelnen Ausführungen nicht zurückgesetzt.

PARAMETER

-AppToken

Das AppToken, das für den Aufruf der PowerShell Universal Management-API verwendet wird. Sie können auch Connect-PSUServer vor dem Aufruf dieses Cmdlets ausführen, um das AppToken für die gesamte Sitzung festzulegen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Arguments

Argumente, die beim Starten der Umgebung an den PowerShell-Prozess übergeben werden.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

Gibt den Computernamen oder die URL an, die beim Zugriff auf die PowerShell Universal Management-API aufgerufen werden soll. Sie können auch Connect-PSUServer vor dem Aufruf dieses Cmdlets verwenden, um den Computernamen für die gesamte Sitzung festzulegen.

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

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

-Modules

Module, die beim Erstellen neuer Runspaces in der Umgebung automatisch geladen werden.

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

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

-Name

Der Name der Umgebung.

Type: String
Parameter Sets: (All)
Aliases:

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

-PSModulePath

Zusätzliche Pfade, die dem PSModulePath für die Umgebung hinzugefügt werden.

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

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

-Path

Der Pfad zur ausführbaren PowerShell-Programmdatei.

Type: String
Parameter Sets: (All)
Aliases:

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

-PersistentRunspace

Gibt an, ob persistente Runspaces aktiviert werden. Dies wird nur für APIs verwendet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Variables

Variablen, die in den Runspace importiert werden sollen. Dies sind mit New-PSUVariable definierte Variablen.

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

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

-UseDefaultCredentials

Standard-Anmeldeinformationen bei der Verbindung mit der Management-API verwenden

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-StartupScript

Ein Skript, das beim Erstellen der Runspaces in dieser Umgebung ausgeführt wird.

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

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

-Version

Eine anzuzeigende Versionsnummer.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunspaceRecycling

Gibt an, ob Runspaces recycelt werden. Runspaces werden nach einer bestimmten Zeit oder einer bestimmten Anzahl von Verwendungen recycelt (verworfen und neu erstellt).

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-MaxRunspaces

Die maximale Anzahl von Runspaces, die für diese Umgebung erstellt werden.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-EnableDebugger

Aktiviert die PowerShell-Debugging-Funktion für diese Umgebung.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Die für diese Umgebung zu verwendenden Anmeldeinformationen

Type: Variable
Parameter Sets: (All)
Aliases:

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

-MaxVirtualMemory

Der maximale virtuelle Speicher in Bytes. Wenn der Grenzwert erreicht wird, wird der Prozess neu gestartet. Wird für die integrierte Umgebung ignoriert.

Type: Int64
Parameter Sets: (All)
Aliases:

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

-RecycleSchedule

Ein CRON-Zeitplan zum Neustarten dieser Umgebung. Wird für die integrierte Umgebung ignoriert.

Type: String
Parameter Sets: (All)
Aliases:

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

-Description

Eine Beschreibung für diese Umgebung.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableImplicitWinCompat

Deaktiviert den impliziten Kompatibilitätsmodus von Windows PowerShell.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Minimal

Eine minimale Umgebung, die keine Module oder Variablen lädt.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProcessStartupScript

Ein Skript, das einmal beim Start des Prozesses ausgeführt wird. Es wird nicht für jeden Runspace ausgeführt.

Type: String
Parameter Sets: (All)
Aliases:

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

-Disabled

Die Umgebung ist deaktiviert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Gibt an, ob das Cmdlet Zertifikatsprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Type

Der Typ der Umgebung. PowerShell 7 und Windows PowerShell 5.1 werden unterstützt. Verwenden Sie Custom, um eine benutzerdefinierte Umgebung zu erstellen

Type: EnvironmentType
Parameter Sets: (All)
Aliases:

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

-Verb

Das Verb, das beim Erstellen des Prozesses für diese Umgebung verwendet wird. Dies wird für die integrierte Umgebung nicht verwendet.

Type: String
Parameter Sets: (All)
Aliases:

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

-Cookies

Verwendet Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung erneut und speichert sie dauerhaft.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.