New-PSUScript
SYNOPSIS
Crée un nouveau script dans PowerShell Universal.
SYNTAXE
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
DESCRIPTION
Crée un nouveau script dans PowerShell Universal. Les scripts peuvent être exécutés manuellement ou planifiés dans PSU. Les scripts créés en fonction du contenu seront écrits dans le répertoire du dépôt. Les scripts créés par chemin seront référencés par ce chemin.
Les configurations de script sont stockées dans .universal/scripts.ps1
Vous pouvez également utiliser cette applet de commande pour créer des scripts par l'intermédiaire de l'API REST.
EXEMPLES
Exemple 1
Crée un script dans PSU qui référence un chemin relatif de Script1.ps1 dans le dossier du dépôt.
Exemple 2
Crée un script dans PSU en fonction du bloc de script fourni. Cela créera un fichier Script1.ps1 dans le répertoire du dépôt.
PARAMÈTRES
-AppToken
Le AppToken utilisé pour appeler l'API de gestion de PowerShell Universal. Vous pouvez également appeler Connect-PSUServer avant d'appeler cette applet de commande pour définir le AppToken pour toute la session.
-ComputerName
Spécifie le nom d'ordinateur ou l'URL qui doit être appelé lors de l'accès à l'API de gestion de PowerShell Universal. Vous pouvez aussi utiliser Connect-PSUServer avant d'appeler cette applet de commande pour définir le nom d'ordinateur pour toute la session.
-Description
La description du script.
-DisableManualInvocation
Désactive l'invocation manuelle du script. Le script ne peut être exécuté que selon une planification.
-ManualTime
Le temps qu'il faudrait pour exécuter ce script en particulier manuellement.
-MaxHistory
L'historique maximal des tâches pour ce script. La valeur par défaut est 100.
-Name
Le nom de ce script.
-Notes
Notes à inclure avec ce script.
-Parameter
Obsolète
-Path
Le chemin vers le script. Il peut s'agir d'un chemin relatif au répertoire du dépôt ou d'un chemin absolu.
-ScriptBlock
Un bloc de script à définir pour ce script.
-Status
Non utilisé.
-Tag
Étiquettes à attribuer à ce script.
-ConcurrentJobs
Le nombre de tâches simultanées autorisées pour ce script. Par défaut, il n'y a aucune limite.
-Environment
L'environnement dans lequel exécuter ce script.
-TimeOut
Le nombre de minutes avant l'expiration des tâches basées sur ce script.
-Credential
La variable d'identifiant utilisateur à utiliser lors de l'exécution de ce script.
-UseDefaultCredentials
Utiliser les identifiants par défaut lors de la connexion à l'API de gestion
-Integrated
Exécute la commande en interne plutôt qu'en utilisant l'API de gestion. Fonctionne uniquement lors de l'exécution du script depuis PowerShell Universal.
-RetryLimit
Le nombre de fois qu'il faut réessayer ce script s'il échoue.
-DiscardPipeline
Indique s'il faut ignorer la sortie du pipeline plutôt que de la conserver dans la base de données.
-LoadProfile
Charge le profil utilisateur lors de l'exécution de ce script en tant qu'autre utilisateur.
-WorkingDirectory
Le répertoire de travail du script.
-Command
La commande qui définit ce script.
-Module
Le module qui contient la commande qui définit ce script.
-Role
Le rôle requis pour exécuter ce script.
-AvailableInBranch
Lorsque spécifié, ce script sera disponible uniquement dans les branches spécifiées.
-PortalOutputType
Le type de sortie du portail à afficher lors de l'exécution de ce script dans le portail.
-TrustCertificate
Indique si l'applet de commande doit ignorer les problèmes de certificat.
-PortalOpenInNewWindow
Indique s'il faut ouvrir ce script dans une nouvelle fenêtre lors de sa consultation dans le portail.
-Icon
Une icône à afficher dans le portail.
-DisplayOutputOnExecute
Affiche la sortie du script pendant son exécution dans le portail.
-PortalBehavior
Comment ce script se comporte dans le portail.
-PortalLeaveForm
Indique s'il faut quitter le formulaire du script après son exécution dans le portail.
-Cookies
Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle.
-ExecutionRole
Spécifie un ou plusieurs rôles qui peuvent exécuter la ressource.
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'informations, consultez about_CommonParameters.
ENTRÉES
Aucune
SORTIES
System.Object
NOTES
LIENS CONNEXES
Mis à jour
Ce contenu vous a-t-il été utile ?