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?