Set-PSUEnvironment

SYNOPSIS

Aktualisiert eine bestehende Ausführungsumgebung.

SYNTAX

Id

Set-PSUEnvironment [-Id] <Int64> [-Name <String>] [-Path <String>] [-Arguments <String>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

Environment

Set-PSUEnvironment [-Environment] <ExecutionEnvironment> [-Name <String>] [-Path <String>]
 [-Arguments <String>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

DESCRIPTION

Aktualisiert eine bestehende Ausführungsumgebung anhand der Id oder durch Übergabe eines Umgebungsobjekts über die Pipeline.

EXAMPLES

Beispiel 1

PS C:\> Set-PSUEnvironment -Id 3 -Name "PowerShell 7" -Path "C:\\Program Files\\PowerShell\\7\\pwsh.exe"

Aktualisiert Umgebung 3 so, dass sie auf eine ausführbare PowerShell 7-Programmdatei verweist.

PARAMETERS

-AppToken

Gibt das App-Token an, das bei der Authentifizierung an der PowerShell Universal-Verwaltungs-API verwendet werden soll.

Type: String
Parameter Sets: (All)
Aliases:

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

-Arguments

Gibt zusätzliche Argumente an, die an die ausführbare Programmdatei oder den 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 die URL oder den Hostnamen der Ziel-Instanz von PowerShell Universal an. Reine Hostnamen werden zu einer http://<host>:5000-URL normalisiert.

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

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

-Environment

Gibt die zu verwendende Ausführungsumgebung an.

Type: ExecutionEnvironment
Parameter Sets: Environment
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Id

Gibt die numerische Id der Ressource an.

Type: Int64
Parameter Sets: Id
Aliases:

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

-Integrated

Verwendet den prozessinternen integrierten Verwaltungsclient, wenn das Cmdlet 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

-Name

Gibt den Namen der Ressource an.

Type: String
Parameter Sets: (All)
Aliases:

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

-Path

Gibt den für die Ressource zu verwendenden Pfad an.

Type: String
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Ob beim Verbinden mit PowerShell Universal die Standardanmeldeinformationen verwendet werden sollen. Erfordert, dass die Windows-Authentifizierung aktiviert ist.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Credential

Anmeldeinformationen für die Anmeldung an der PowerShell Universal-Verwaltungs-API.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

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

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

INPUTS

PowerShellUniversal.ExecutionEnvironment

OUTPUTS

System.Object

NOTES

RELATED LINKS