New-PSUScript
SINOPSIS
Crea un script dentro de PowerShell Universal.
SINTAXIS
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
DESCRIPCIÓN
Crea un script dentro de PowerShell Universal. Los scripts pueden ejecutarse manualmente o programarse dentro de PSU. Los scripts creados a partir de contenido se escribirán en el directorio del repositorio. Los scripts creados mediante ruta se referenciarán por esa ruta.
Las configuraciones de los scripts se almacenan en .universal/scripts.ps1
También puede usar este cmdlet para crear scripts a través de la API REST.
EJEMPLOS
Ejemplo 1
Crea un script dentro de PSU que referencia una ruta relativa de Script1.ps1 en la carpeta del repositorio.
Ejemplo 2
Crea un script dentro de PSU basado en el bloque de script proporcionado. Esto creará un fichero Script1.ps1 dentro del directorio del repositorio.
PARÁMETROS
-AppToken
El AppToken que se usa para llamar a la API de gestión de PowerShell Universal. También puede llamar a Connect-PSUServer antes de llamar a este cmdlet para establecer el AppToken para toda la sesión.
-ComputerName
Especifica el nombre del ordenador o la URL que se debe llamar al acceder a la API de gestión de PowerShell Universal. También puede usar Connect-PSUServer antes de llamar a este cmdlet para establecer el nombre del ordenador para toda la sesión.
-Description
La descripción del script.
-DisableManualInvocation
Deshabilita la invocación manual del script. El script solo puede ejecutarse según una programación.
-ManualTime
El tiempo que llevaría ejecutar este script en particular de forma manual.
-MaxHistory
El historial máximo de trabajos para este script. El valor predeterminado es 100.
-Name
El nombre de este script.
-Notes
Notas que se incluirán con este script.
-Parameter
Obsoleto
-Path
La ruta al script. Puede ser una ruta relativa al directorio del repositorio o una ruta absoluta.
-ScriptBlock
Un bloque de script para definir para este script.
-Status
No se utiliza.
-Tag
Etiquetas que se asignarán a este script.
-ConcurrentJobs
El número de trabajos simultáneos permitidos para este script. De forma predeterminada, no hay límite.
-Environment
El entorno en el que ejecutar este script.
-TimeOut
El número de minutos antes de que los trabajos basados en este script expiren.
-Credential
La variable de credencial de usuario que se utilizará al ejecutar este script.
-UseDefaultCredentials
Usar credenciales predeterminadas al conectarse a la API de gestión
-Integrated
Ejecuta el comando internamente en lugar de usar la API de gestión. Solo funciona cuando se ejecuta el script desde dentro de PowerShell Universal.
-RetryLimit
El número de veces que se reintentará este script si falla.
-DiscardPipeline
Si se debe descartar la salida de la canalización en lugar de persistirla en la base de datos.
-LoadProfile
Carga el perfil de usuario al ejecutar este script como otro usuario.
-WorkingDirectory
El directorio de trabajo del script.
-Command
El comando que define este script.
-Module
El módulo que contiene el comando que define este script.
-Role
El rol que se requiere para ejecutar este script.
-AvailableInBranch
Cuando se especifica, este script solo estará disponible en las ramas indicadas.
-PortalOutputType
El tipo de salida del portal que se mostrará al ejecutar este script en el portal.
-TrustCertificate
Si el cmdlet debe ignorar los problemas de certificado.
-PortalOpenInNewWindow
Si se debe abrir este script en una nueva ventana al verlo en el portal.
-Icon
Un icono que se mostrará en el portal.
-DisplayOutputOnExecute
Muestra la salida del script mientras se ejecuta en el portal.
-PortalBehavior
Cómo se comporta este script en el portal.
-PortalLeaveForm
Si se debe salir del formulario del script después de ejecutarlo en el portal.
-Cookies
Reutiliza y persiste las cookies de autenticación para la sesión actual de PowerShell.
-ExecutionRole
Especifica uno o más roles que pueden ejecutar el recurso.
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para más información, consulte about_CommonParameters.
ENTRADAS
Ninguna
SALIDAS
System.Object
NOTAS
ENLACES RELACIONADOS
Última actualización
¿Te fue útil?