New-PSUApp
ÜBERSICHT
Erstellt eine neue App in PowerShell Universal.
SYNTAX
FilePath (Standard)
New-PSUApp [-FilePath <String>] [-BaseUrl <String>] -Name <String> [-Environment <String>] [-GrantAppToken]
[-Maintenance] [-Authenticated] [-Role <String[]>] [-DisableAutoStart] [-Component <DashboardComponent[]>]
[-SessionTimeout <Int32>] [-IdleTimeout <Int32>] [-AutoDeploy] [-Description <String>] [-Credential <String>]
[-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag <Tag[]>] [-DisableInteractiveHost]
[-FavIcon <String>] [-OnSessionTimeout <ScriptBlock>] [-ComputerGroup <String[]>]
[-AvailableInBranch <String[]>] [-Critical] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Content
New-PSUApp -Content <ScriptBlock> [-BaseUrl <String>] -Name <String> [-Environment <String>] [-GrantAppToken]
[-Maintenance] [-Authenticated] [-Role <String[]>] [-DisableAutoStart] [-Component <DashboardComponent[]>]
[-SessionTimeout <Int32>] [-IdleTimeout <Int32>] [-AutoDeploy] [-Description <String>] [-Credential <String>]
[-DisableErrorToast] [-DisableStartupLog] [-VerboseErrorMessages] [-Tag <Tag[]>] [-DisableInteractiveHost]
[-FavIcon <String>] [-OnSessionTimeout <ScriptBlock>] [-ComputerGroup <String[]>]
[-AvailableInBranch <String[]>] [-Critical] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Module
BESCHREIBUNG
Erstellt eine neue App in PowerShell Universal.
BEISPIELE
Beispiel 1
Erstellt eine App mithilfe der Datei app.ps1 im Repository-Verzeichnis und stellt sie unter der Basis-URL /app bereit.
PARAMETER
-AppToken
Das AppToken, das zum Aufrufen der PowerShell Universal Management API verwendet wird. Sie können auch Connect-PSUServer aufrufen, bevor Sie dieses Cmdlet ausführen, um das AppToken für die gesamte Sitzung festzulegen.
-Authenticated
Wenn angegeben, wird die Authentifizierung für diese App aktiviert.
-AutoDeploy
Ob diese App bereitgestellt werden soll, wenn Änderungen vorgenommen werden. 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
Nicht verwendet. Nur aus Gründen der Rückwä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 verwenden, bevor Sie dieses Cmdlet aufrufen, 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 Start des Servers 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 werden nicht mehr funktionieren.
-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 zur 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 der angemeldete 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, der zum Definieren dieser App verwendet wird.
-Name
Der Name dieser App.
-Role
Rollen, die Zugriff auf diese App haben.
-SessionTimeout
Das Sitzungs-Timeout für diese App.
-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
Gibt die Computergruppe an, die als Ziel verwendet oder zugewiesen werden soll.
-OnSessionTimeout
Gibt den Skriptblock an, der ausgeführt werden soll, wenn eine App-Sitzung abläuft.
-AvailableInBranch
Wenn angegeben, wird diese App nur in den angegebenen Branches angezeigt und ausgeführt.
-TrustCertificate
Ob das Cmdlet Zertifikatsprobleme ignorieren soll.
-Critical
App ist kritisch. Dies führt dazu, dass der Endpunkt /api/v1/status eine 500 zurückgibt, wenn die App nicht gestartet wurde.
-Cookies
Verwendet und speichert Authentifizierungscookies für die aktuelle PowerShell-Sitzung.
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.
EINGABEN
Keine
AUSGABEN
System.Object
HINWEISE
VERWANDTE LINKS
Zuletzt aktualisiert
War das hilfreich?