New-PSUScript
SINOSSI
Crea un nuovo script in PowerShell Universal.
SINTASSI
ScriptBlock
New-PSUScript -ScriptBlock <ScriptBlock> [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String>
[-Description <String>] [-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>]
[-Environment <String>] [-Notes <String>] [-DisableManualInvocation] [-Path <String>] [-MaxHistory <Int32>]
[-ConcurrentJobs <Int32>] [-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile]
[-WorkingDirectory <String>] [-Role <String[]>] [-PortalOutputType <PortalOutputType>]
[-AvailableInBranch <String[]>] [-PortalOpenInNewWindow] [-Icon <String>]
[-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm] [-DisplayOutputOnExecute]
[-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials]
[-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]Path
New-PSUScript [-ManualTime <Int32>] [-TimeOut <Double>] -Name <String> [-Description <String>]
[-Parameter <ScriptParameter[]>] [-Tag <Tag[]>] [-Status <ScriptStatus>] [-Environment <String>]
[-Notes <String>] [-DisableManualInvocation] -Path <String> [-MaxHistory <Int32>] [-ConcurrentJobs <Int32>]
[-Credential <Variable>] [-RetryLimit <Int32>] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory <String>]
[-Role <String[]>] [-PortalOutputType <PortalOutputType>] [-AvailableInBranch <String[]>]
[-PortalOpenInNewWindow] [-Icon <String>] [-PortalBehavior <ScriptPortalBehavior>] [-PortalLeaveForm]
[-DisplayOutputOnExecute] [-ExecutionRole <String[]>] [-ComputerName <String>] [-AppToken <String>]
[-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
[<CommonParameters>]Module
DESCRIZIONE
Crea un nuovo script in PowerShell Universal. Gli script possono essere eseguiti manualmente o pianificati all'interno di PSU. Gli script creati in base al contenuto verranno scritti nella directory del repository. Gli script creati tramite percorso verranno referenziati da tale percorso.
Le configurazioni degli script sono archiviate in .universal/scripts.ps1
È inoltre possibile utilizzare questo cmdlet per creare script tramite l'API REST.
ESEMPI
Esempio 1
Crea uno script in PSU che fa riferimento a un percorso relativo di Script1.ps1 nella cartella del repository.
Esempio 2
Crea uno script in PSU basato sul blocco di script fornito. In questo modo verrà creato un file Script1.ps1 all'interno della directory del repository.
PARAMETRI
-AppToken
L'AppToken utilizzato per chiamare l'API di gestione di PowerShell Universal. È inoltre possibile chiamare Connect-PSUServer prima di questo cmdlet per impostare l'AppToken per l'intera sessione.
-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 chiamare questo cmdlet per impostare il nome del computer per l'intera sessione.
-Description
La descrizione dello script.
-DisableManualInvocation
Disabilita l'invocazione manuale dello script. Lo script può essere eseguito solo in base a una pianificazione.
-ManualTime
Il tempo necessario per eseguire manualmente questo specifico script.
-MaxHistory
La cronologia massima dei processi per questo script. Il valore predefinito è 100.
-Name
Il nome di questo script.
-Notes
Note da includere con questo script.
-Parameter
Obsoleto
-Path
Il percorso dello script. Può essere un percorso relativo alla directory del repository o un percorso assoluto.
-ScriptBlock
Un blocco di script da definire per questo script.
-Status
Non utilizzato.
-Tag
Tag da assegnare a questo script.
-ConcurrentJobs
Il numero di processi simultanei consentiti per questo script. Per impostazione predefinita, non è previsto alcun limite.
-Environment
L'ambiente in cui eseguire questo script.
-TimeOut
Il numero di minuti prima che i processi basati su questo script vadano in timeout.
-Credential
La variabile delle credenziali utente da utilizzare durante l'esecuzione di questo script.
-UseDefaultCredentials
Utilizza le credenziali predefinite durante la connessione all'API di gestione
-Integrated
Esegue il comando internamente anziché tramite l'API di gestione. Funziona solo quando lo script viene eseguito all'interno di PowerShell Universal.
-RetryLimit
Il numero di tentativi di riesecuzione di questo script in caso di errore.
-DiscardPipeline
Indica se scartare l'output della pipeline anziché renderlo persistente nel database.
-LoadProfile
Carica il profilo utente quando si esegue questo script come un altro utente.
-WorkingDirectory
La directory di lavoro dello script.
-Command
Il comando che definisce questo script.
-Module
Il modulo che contiene il comando che definisce questo script.
-Role
Il ruolo necessario per eseguire questo script.
-AvailableInBranch
Se specificato, questo script sarà disponibile solo nei branch indicati.
-PortalOutputType
Il tipo di output del portale da visualizzare durante l'esecuzione di questo script nel portale.
-TrustCertificate
Indica se il cmdlet deve ignorare i problemi relativi ai certificati.
-PortalOpenInNewWindow
Indica se aprire questo script in una nuova finestra durante la visualizzazione nel portale.
-Icon
Un'icona da visualizzare nel portale.
-DisplayOutputOnExecute
Visualizza l'output dello script mentre viene eseguito nel portale.
-PortalBehavior
Il comportamento di questo script nel portale.
-PortalLeaveForm
Indica se uscire dal modulo dello script dopo averlo eseguito nel portale.
-Cookies
Riutilizza e rende persistenti i cookie di autenticazione per la sessione PowerShell corrente.
-ExecutionRole
Specifica uno o più ruoli che possono eseguire la risorsa.
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per ulteriori informazioni, veda about_CommonParameters.
INPUT
None
OUTPUT
System.Object
NOTE
COLLEGAMENTI CORRELATI
Ultimo aggiornamento
È stato utile?