> 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/it/comandi-powershell/new-psuvariable.md).

# New-PSUVariable

New-PSUVariable crea una nuova variabile in PowerShell Universal, facoltativamente archiviata come segreto, valore di database o con ambito limitato a ruoli specifici.

## SINOSSI

Crea una variabile di PowerShell Universal.

## SINTASSI

```powershell
New-PSUVariable -Name <String> [-Value <Object>] [<VariableOptions>] [<ConnectionOptions>]
New-PSUVariable -Name <String> [-InputObject <Object>] [<VariableOptions>] [<ConnectionOptions>]
New-PSUVariable -Name <String> -Vault <String> [-Value <Object>] [-InputObject <Object>] [<VariableOptions>] [<ConnectionOptions>]
```

`<VariableOptions>`: `[-Type <String>] [-Description <String>] [-DisableRunAsSupport] [-Database] [-Required] [-Role <String[]>] [-Force] [-Scope <VariableScope>] [-Tag <Tag[]>] [-PasswordNotRequired]`. `<ConnectionOptions>`: `[-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]`.

## DESCRIZIONE

Crea una variabile disponibile per gli script PSU. `-InputObject` senza `-Vault` serializza il suo valore come `PSObject`; nel set di parametri Secret, `-InputObject` è accettato, ma non viene convertito nel `-Value` archiviato. Un `PSCredential` fornito tramite `-Value` archivia il nome utente e la password con il tipo `PSCredential`. I nomi di variabile esistenti (senza distinzione tra maiuscole e minuscole) vengono rifiutati, a meno che non sia indicato `-Force`. `-Required` contrassegna una variabile come obbligatoria e i requisiti dei moduli dell'ambiente possono usarlo affinché un modulo non sia considerato pronto finché la variabile non è disponibile.

## ESEMPIO

```powershell
New-PSUVariable -Name 'ApiKey' -Required -Description 'API key required by the integration'
```

## PARAMETRI

| Parametro                | Descrizione                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------- |
| `-Name`                  | Nome di variabile univoco e obbligatorio.                                                               |
| `-Value`                 | Valore da archiviare; i valori stringa possono essere deserializzati da CLIXML.                         |
| `-InputObject`           | Oggetto serializzato come `PSObject` solo nel set di parametri InputObject (senza `-Vault`).            |
| `-Vault`                 | Nome dell'archivio dei segreti per il set di parametri Secret.                                          |
| `-Type`                  | Tipo della variabile, `System.String` per impostazione predefinita quando nessun valore lo sostituisce. |
| `-Description`           | Descrizione della variabile.                                                                            |
| `-DisableRunAsSupport`   | Disabilita l'uso come credenziale di esecuzione.                                                        |
| `-Database`              | Archivia il valore nel database.                                                                        |
| `-Required`              | Contrassegna la variabile come obbligatoria.                                                            |
| `-Role`                  | Ruoli autorizzati ad accedere alla variabile.                                                           |
| `-Force`                 | Consente la creazione quando il nome esiste già.                                                        |
| `-Scope`                 | Ambito della variabile.                                                                                 |
| `-Tag`                   | Tag della variabile.                                                                                    |
| `-PasswordNotRequired`   | Contrassegna la password di una credenziale come non obbligatoria.                                      |
| `-ComputerName`          | URL o nome host del server PSU di destinazione (alias `-Uri`).                                          |
| `-AppToken`              | Token dell'app dell'API di gestione.                                                                    |
| `-Credential`            | Credenziali dell'API di gestione.                                                                       |
| `-UseDefaultCredentials` | Usa le credenziali Windows correnti.                                                                    |
| `-Integrated`            | Usa il client di gestione nel processo.                                                                 |
| `-TrustCertificate`      | Ignora gli errori di convalida del certificato.                                                         |
| `-Cookies`               | Riutilizza i cookie di autenticazione della sessione.                                                   |

## AUTORIZZAZIONI

Il token di accesso richiede `platform.variables/create` per eseguire questo cmdlet in remoto.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/powershell-universal/it/comandi-powershell/new-psuvariable.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.