> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/new-psuscript.md). # New-PSUScript ## SINOPSIS Crea un script dentro de PowerShell Universal. ## SINTAXIS ### ScriptBlock ``` New-PSUScript -ScriptBlock [-ManualTime ] [-TimeOut ] -Name [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] [-Path ] [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Path ``` New-PSUScript [-ManualTime ] [-TimeOut ] -Name [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] -Path [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Module ``` New-PSUScript [-ManualTime ] [-TimeOut ] [-Description ] [-Parameter ] [-Tag ] [-Status ] [-Environment ] [-Notes ] [-DisableManualInvocation] [-MaxHistory ] [-ConcurrentJobs ] [-Credential ] [-RetryLimit ] [-DiscardPipeline] [-LoadProfile] [-WorkingDirectory ] -Module -Command [-Role ] [-PortalOutputType ] [-AvailableInBranch ] [-PortalOpenInNewWindow] [-Icon ] [-PortalBehavior ] [-PortalLeaveForm] [-DisplayOutputOnExecute] [-ExecutionRole ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## 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 ``` New-PSUScript -Name 'Script1.ps1' -Path 'Script1.ps1' ``` Crea un script dentro de PSU que referencia una ruta relativa de Script1.ps1 en la carpeta del repositorio. ### Ejemplo 2 ``` New-PSUScript -Name 'Script1.ps1' -ScriptBlock { "Hello, world!" } ``` 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. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -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. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description La descripción del script. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableManualInvocation Deshabilita la invocación manual del script. El script solo puede ejecutarse según una programación. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: False Accept pipeline input: False Accept wildcard characters: False ``` ### -ManualTime El tiempo que llevaría ejecutar este script en particular de forma manual. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -MaxHistory El historial máximo de trabajos para este script. El valor predeterminado es 100. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name El nombre de este script. ```yaml Type: String Parameter Sets: ScriptBlock, Path Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Notes Notas que se incluirán con este script. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Parameter Obsoleto ```yaml Type: ScriptParameter[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Path La ruta al script. Puede ser una ruta relativa al directorio del repositorio o una ruta absoluta. ```yaml Type: String Parameter Sets: ScriptBlock Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ```yaml Type: String Parameter Sets: Path Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ScriptBlock Un bloque de script para definir para este script. ```yaml Type: ScriptBlock Parameter Sets: ScriptBlock Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Status No se utiliza. ```yaml Type: ScriptStatus Parameter Sets: (All) Aliases: Accepted values: Draft, Pending_Review, Published, Disabled Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tag Etiquetas que se asignarán a este script. ```yaml Type: Tag[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ConcurrentJobs El número de trabajos simultáneos permitidos para este script. De forma predeterminada, no hay límite. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Environment El entorno en el que ejecutar este script. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TimeOut El número de minutos antes de que los trabajos basados en este script expiren. ```yaml Type: Double Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential La variable de credencial de usuario que se utilizará al ejecutar este script. ```yaml Type: Variable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Usar credenciales predeterminadas al conectarse a la API de gestión ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -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. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RetryLimit El número de veces que se reintentará este script si falla. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DiscardPipeline Si se debe descartar la salida de la canalización en lugar de persistirla en la base de datos. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -LoadProfile Carga el perfil de usuario al ejecutar este script como otro usuario. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -WorkingDirectory El directorio de trabajo del script. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Command El comando que define este script. ```yaml Type: String Parameter Sets: Module Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Module El módulo que contiene el comando que define este script. ```yaml Type: String Parameter Sets: Module Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role El rol que se requiere para ejecutar este script. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AvailableInBranch Cuando se especifica, este script solo estará disponible en las ramas indicadas. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalOutputType El tipo de salida del portal que se mostrará al ejecutar este script en el portal. ```yaml Type: PortalOutputType Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Si el cmdlet debe ignorar los problemas de certificado. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalOpenInNewWindow Si se debe abrir este script en una nueva ventana al verlo en el portal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Icon Un icono que se mostrará en el portal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisplayOutputOnExecute Muestra la salida del script mientras se ejecuta en el portal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalBehavior Cómo se comporta este script en el portal. ```yaml Type: ScriptPortalBehavior Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PortalLeaveForm Si se debe salir del formulario del script después de ejecutarlo en el portal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Reutiliza y persiste las cookies de autenticación para la sesión actual de PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ExecutionRole Especifica uno o más roles que pueden ejecutar el recurso. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### 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](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRADAS ### Ninguna ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS [Get-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/es/powershell-universal/cmdlets/Get-PSUScript/README.md) [Remove-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/es/powershell-universal/cmdlets/Remove-PSUScript/README.md) [Invoke-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/es/powershell-universal/cmdlets/Invoke-PSUScript/README.md) [Set-PSUScript](https://github.com/Devolutions/docs/tree/master/translations/es/powershell-universal/cmdlets/Set-PSUScript/README.md) [Get-PSUEnvironment](https://github.com/Devolutions/docs/tree/master/translations/es/powershell-universal/cmdlets/Get-PSUEnvironment/README.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/es/comandos-de-powershell/new-psuscript.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.