For the complete documentation index, see llms.txt. This page is also available as Markdown.

New-PSUDashboard

Übersicht

Erstellt eine neue App in PowerShell Universal.

Syntax

New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Command <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] [-Module <String>] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]

New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] -Content <ScriptBlock> [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]

New-PSUDashboard [-AppToken <String>] [-Authenticated] [-AutoDeploy] [-BaseUrl <String>] [-Component <DashboardComponent[]>] [-ComputerName <String>] [-Credential <String>] [-Description <String>] [-DisableAutoStart] [-DisableErrorToast] [-DisableInteractiveHost] [-DisableStartupLog] [-Environment <String>] [-FavIcon <String>] [-FilePath <String>] [-GrantAppToken] [-IdleTimeout <Int32>] [-Integrated] [-Maintenance] -Name <String> [-Role <String[]>] [-SessionTimeout <Int32>] [-Tag <Tag[]>] [-UseDefaultCredentials] [-VerboseErrorMessages] [-ComputerGroup <String[]>] [-OnSessionTimeout <ScriptBlock>] [-AvailableInBranch <String[]>] [-TrustCertificate] [-Critical] [<CommonParameters>]

Beschreibung

Erstellt eine neue App in PowerShell Universal.

Parameter

-AppToken

Das AppToken, das für den Aufruf der PowerShell Universal Management API verwendet wird. Sie können auch Connect-PSUServer vor diesem Cmdlet aufrufen, um das AppToken für die gesamte Sitzung festzulegen.

Required?                    false
Position?                    named
Default value                None
Accept pipeline input?       False
Aliases                      none
Accept wildcard characters?  false

-Authenticated

Wenn angegeben, ist die Authentifizierung für diese App aktiviert.

-AutoDeploy

Ob diese App bei Änderungen bereitgestellt werden soll. Wenn nicht angegeben, muss die App neu gestartet werden, bevor Änderungen angewendet werden.

-BaseUrl

Die Basis-URL für den Zugriff auf diese App. Sie können / verwenden, um die App im Stammverzeichnis des Servers bereitzustellen, oder /app, um die App unter /app bereitzustellen.

-Command

Der Befehl, der zum Erstellen dieser App verwendet wird.

-Component <DashboardComponent[]>

Nicht verwendet. Nur zur Abwärtskompatibilität vorhanden.

-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 diesem Cmdlet verwenden, um den Computernamen für die gesamte Sitzung festzulegen.

-Content

Der Inhalt dieser App.

-Credential

Die Benutzeranmeldeinformationen, unter denen diese App ausgeführt wird.

-Description

Eine Beschreibung dieser App.

-DisableAutoStart

Ob der automatische Start dieser App beim Serverstart deaktiviert werden soll.

-DisableErrorToast

Ob Fehler-Toasts für diese App deaktiviert werden sollen.

-DisableInteractiveHost

Ob der interaktive Host für diese App deaktiviert werden soll. Write-Host, Read-Host, Get-Credential und andere Funktionen funktionieren dann nicht mehr.

-DisableStartupLog

Ob das Startprotokoll für diese App deaktiviert werden soll.

-Environment

Die Umgebung, in der diese App ausgeführt wird.

-FavIcon

Die URL zum Favicon für diese App.

-FilePath

Der Pfad zu der Datei, die den Inhalt für diese App enthält.

-GrantAppToken

Ob Benutzern dieser App ein App-Token gewährt werden soll. Sie können das App-Token innerhalb Ihrer App verwenden, um als angemeldeter Benutzer auf Ressourcen von PSU zuzugreifen.

-IdleTimeout

Das Leerlauf-Timeout für diese App.

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

-Maintenance

Ob diese App in den Wartungsmodus versetzt werden soll. Im Wartungsmodus können nur Administratoren auf die App zugreifen.

-Module

Das Modul, das den Befehl enthält, mit dem diese App definiert wird.

-Name

Der Name dieser App.

-Role <String[]>

Rollen, die Zugriff auf diese App haben.

-SessionTimeout

Das Sitzungs-Timeout für diese App.

-Tag <Tag[]>

Tags, die auf diese App angewendet werden sollen.

-UseDefaultCredentials

Standardanmeldeinformationen bei der Verbindung mit der Management API verwenden

-VerboseErrorMessages

Ob ausführliche Fehlermeldungen für diese App angezeigt werden sollen.

-ComputerGroup <String[]>

{{ Fill ComputerGroup Description }}

-OnSessionTimeout

{{ Fill OnSessionTimeout Description }}

-AvailableInBranch <String[]>

Wenn angegeben, wird diese App nur in den angegebenen Branches angezeigt und ausgeführt.

-TrustCertificate

Ob das Cmdlet Zertifikatsprobleme ignorieren soll.

-Critical

Die App ist kritisch. Dadurch gibt der Endpunkt /api/v1/status den Status 500 zurück, wenn die App nicht gestartet wurde.

Allgemeine Parameter

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

Eingaben

Keine

Ausgaben

System.Object

Hinweise

Beispiele

Beispiel 1

Erstellt eine App mithilfe der Datei app.ps1 im Repository-Verzeichnis und stellt sie unter der Basis-URL /app bereit.

Zuletzt aktualisiert

War das hilfreich?