> 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-psuvariable.md). # New-PSUVariable ## SINOPSIS Crea una nueva variable en PSU. ## SINTAXIS ### Value (predeterminado) ``` New-PSUVariable -Name [-Value ] [-Type ] [-Description ] [-DisableRunAsSupport] [-Database] [-Role ] [-Force] [-Scope ] [-Tag ] [-PasswordNotRequired] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Secret ``` New-PSUVariable -Name [-Value ] [-InputObject ] -Vault [-Type ] [-Description ] [-DisableRunAsSupport] [-Database] [-Role ] [-Force] [-Scope ] [-Tag ] [-PasswordNotRequired] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### InputObject ``` New-PSUVariable -Name [-InputObject ] [-Type ] [-Description ] [-DisableRunAsSupport] [-Database] [-Role ] [-Force] [-Scope ] [-Tag ] [-PasswordNotRequired] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPCIÓN Crea una nueva variable en PSU. Las variables están disponibles en todos los scripts que se ejecutan en PSU. ## EJEMPLOS ### Ejemplo 1 ``` PS C:\> New-UAVariable -Name 'UserName' -Value 'Adam' ``` Crea una nueva variable en PSU llamada \`UserName\`. Puede usar la variable $UserName en todos sus scripts. ### Ejemplo 2 ``` PS C:\> New-UAVariable -Name 'UserName' -Value 'Adam' -Vault "Vault" ``` Crea una nueva variable en la bóveda llamada \`Vault\`. El valor de la variable no se almacena en PSU y solo se recuperará al ejecutar scripts. ## PARÁMETROS ### -AppToken Un token de aplicación para acceder a la API de PSU. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName La dirección HTTP del servidor de la API REST de PSU. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Una descripción para esta variable. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableRunAsSupport Impide que una credencial se utilice para la compatibilidad con Ejecutar como. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -InputObject Un objeto de entrada para almacenar como variable. ```yaml Type: Object Parameter Sets: Secret, InputObject 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 al ejecutar el script desde PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name El nombre de la variable. Puede referenciarlo en sus scripts igual que haría con otras variables. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Type El tipo .NET del objeto . ```yaml Type: String 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 ``` ### -Value El valor de la variable. ```yaml Type: Object Parameter Sets: Value, Secret Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Vault La bóveda en la que almacenar la variable. ```yaml Type: String Parameter Sets: Secret Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Database Almacena el valor de la variable 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 ``` ### -Force Sobrescribe las variables existentes con el mismo nombre. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Los roles que pueden acceder a esta variable. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Credenciales para iniciar sesión en la API de gestión de PowerShell Universal. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Scope El ámbito de variable para esta variable. Los cambios en variables globales provocarán el reinicio de los recursos. Las variables con ámbito de script no lo harán. ```yaml Type: VariableScope Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tag Etiquetas para esta variable. ```yaml Type: Tag[] 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 ``` ### -PasswordNotRequired Especifica que no se requiere la contraseña para esta variable. Esto es útil para cuentas como las cuentas de servicio administradas de grupo. ```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 conserva 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 ``` ### 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 --- # 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-psuvariable.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.