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

New-PSUApp

SINOSSI

Crea una nuova app in PowerShell Universal.

SINTASSI

FilePath (predefinito)

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

DESCRIZIONE

Crea una nuova app in PowerShell Universal.

ESEMPI

Esempio 1

Crea un'app utilizzando il file app.ps1 nella directory del repository e la pubblica all'URL di base /app.

PARAMETRI

-AppToken

L'AppToken utilizzato per chiamare l'API di gestione di PowerShell Universal. È inoltre possibile chiamare Connect-PSUServer prima di eseguire questo cmdlet per impostare l'AppToken per l'intera sessione.

-Authenticated

Se specificato, l'autenticazione è abilitata per questa app.

-AutoDeploy

Indica se distribuire questa app quando vengono apportate modifiche. Se non specificato, è necessario riavviare l'app prima che le modifiche vengano applicate.

-BaseUrl

L'URL di base per accedere a questa app. È possibile utilizzare / per pubblicare l'app nella radice del server oppure /app per pubblicare l'app in /app.

-Command

Il comando utilizzato per creare questa app.

-Component

Non utilizzato. Presente solo per compatibilità con le versioni precedenti.

-ComputerName

Specifica il nome del computer o l'URL da chiamare quando si accede all'API di gestione di PowerShell Universal. È inoltre possibile utilizzare Connect-PSUServer prima di eseguire questo cmdlet per impostare il nome del computer per l'intera sessione.

-Content

Il contenuto di questa app.

-Credential

La credenziale utente con cui eseguire questa app.

-Description

Una descrizione di questa app.

-DisableAutoStart

Indica se disabilitare l'avvio automatico di questa app all'avvio del server.

-DisableErrorToast

Indica se disabilitare i toast di errore per questa app.

-DisableInteractiveHost

Indica se disabilitare l'host interattivo per questa app. Write-Host, Read-Host, Get-Credential e altre funzionalità non funzioneranno più.

-DisableStartupLog

Indica se disabilitare il log di avvio per questa app.

-Environment

L'ambiente in cui eseguire questa app.

-FavIcon

L'URL della favicon per questa app.

-FilePath

Il percorso del file che contiene il contenuto di questa app.

-GrantAppToken

Indica se concedere un token app agli utenti di questa app. È possibile utilizzare il token app all'interno dell'app per accedere alle risorse di PSU come l'utente che effettua l'accesso.

-IdleTimeout

Il timeout di inattività per questa app.

-Integrated

Esegue il comando internamente anziché utilizzare l'API di gestione. Funziona solo quando lo script viene eseguito all'interno di PowerShell Universal.

-Maintenance

Indica se mettere questa app in modalità di manutenzione. Solo gli amministratori potranno accedere all'app quando è in modalità di manutenzione.

-Module

Il modulo che contiene il comando utilizzato per definire questa app.

-Name

Il nome di questa app.

-Role

Ruoli che hanno accesso a questa app.

-SessionTimeout

Il timeout della sessione per questa app.

-Tag

Tag da applicare a questa app.

-UseDefaultCredentials

Utilizza le credenziali predefinite durante la connessione all'API di gestione

-VerboseErrorMessages

Indica se visualizzare messaggi di errore dettagliati per questa app.

-ComputerGroup

Specifica il gruppo di computer da destinare o assegnare.

-OnSessionTimeout

Specifica il blocco di script da eseguire quando una sessione dell'app scade.

-AvailableInBranch

Se specificato, questa app verrà visualizzata ed eseguita solo nei branch specificati.

-TrustCertificate

Indica se il cmdlet deve ignorare i problemi relativi ai certificati.

-Critical

L'app è critica. Ciò farà sì che l'endpoint /api/v1/status restituisca 500 se l'app non è stata avviata.

-Cookies

Riutilizza e mantiene i cookie di autenticazione per la sessione PowerShell corrente.

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per ulteriori informazioni, vedere about_CommonParameters.

INPUT

Nessuno

OUTPUT

System.Object

NOTE

Ultimo aggiornamento

È stato utile?