> 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-psuenvironment.md). # New-PSUEnvironment ## SINOSSI Crea un nuovo ambiente PowerShell Universal. ## SINTASSI ``` New-PSUEnvironment -Name [-Version ] [-Type ] [-Path ] [-Arguments ] [-Modules ] [-Variables ] [-PSModulePath ] [-StartupScript ] [-PersistentRunspace] [-RunspaceRecycling] [-MaxRunspaces ] [-MaxVirtualMemory ] [-RecycleSchedule ] [-Credential ] [-Description ] [-DisableImplicitWinCompat] [-Minimal] [-Disabled] [-ProcessStartupScript ] [-EnableDebugger] [-Verb ] [-ComputerName ] [-AppToken ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIZIONE Gli ambienti definiscono gli ambienti di esecuzione PowerShell all'interno di PowerShell Universal. È possibile utilizzarli durante l'esecuzione di API, script, dashboard e dei processi di sicurezza per l'autenticazione e l'autorizzazione. Gli ambienti sono memorizzati nel file ./universal/environments.ps1. È inoltre possibile utilizzare questo cmdlet per creare ambienti tramite l'API REST. ## ESEMPI ### Esempio 1 ```powershell PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' ``` Crea un nuovo ambiente denominato 7.1 che utilizza pwsh.exe per eseguire API, script o dashboard. ### Esempio 2 ```powershell PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" ``` Crea un nuovo ambiente denominato 7.1 che utilizza l'eseguibile pwsh.exe e imposta i criteri di esecuzione su ByPass. ### Esempio 3 ```powershell PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -Variables @("*") ``` Crea un nuovo ambiente che utilizza tutte le variabili definite con New-PSUVariable. ### Esempio 4 ```powershell PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -Modules @("ActiveDirectory") ``` Crea un nuovo ambiente che carica automaticamente il modulo ActiveDirectory. ### Esempio 5 ```powershell PS C:\> New-PSUEnvironment -Name '7.1' -Path 'pwsh.exe' -ArgumentList "-ExecutionPolicy Bypass" -PersistentRunspace ``` Crea un nuovo ambiente che utilizza runspace persistenti. I runspace persistenti sono utilizzati per le API e non vengono reimpostati tra un'esecuzione e l'altra. ## PARAMETRI ### -AppToken L'AppToken utilizzato per chiamare l'API di gestione di PowerShell Universal. È inoltre possibile chiamare Connect-PSUServer prima di eseguire questo cmdlet per impostare l'AppToken per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Arguments Argomenti da passare al processo PowerShell all'avvio dell'ambiente. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Specifica il nome del computer o l'URL da chiamare per accedere all'API di gestione di PowerShell Universal. È inoltre possibile utilizzare Connect-PSUServer prima di eseguire questo cmdlet per impostare il nome del computer per l'intera sessione. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Modules Moduli da caricare automaticamente durante la creazione di nuovi runspace nell'ambiente. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Il nome dell'ambiente. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PSModulePath Percorsi aggiuntivi da aggiungere al PSModulePath per l'ambiente. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Path Il percorso dell'eseguibile PowerShell. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -PersistentRunspace Indica se abilitare i runspace persistenti. Viene utilizzato solo per le API. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Variables Variabili da importare nel runspace. Si tratta delle variabili definite da New-PSUVariable. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utilizza le credenziali predefinite durante la connessione all'API di gestione ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Esegue il comando internamente anziché utilizzare l'API di gestione. Funziona solo quando lo script viene eseguito all'interno di PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -StartupScript Uno script da eseguire durante la creazione dei runspace in questo ambiente. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Version Un numero di versione da visualizzare. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RunspaceRecycling Indica se riciclare i runspace. I runspace verranno riciclati (eliminati e ricreati) dopo un determinato periodo di tempo o un determinato numero di utilizzi. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -MaxRunspaces Il numero massimo di runspace da creare per questo ambiente. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -EnableDebugger Abilita la funzionalità di debug di PowerShell per questo ambiente. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential La credenziale da utilizzare con questo ambiente ```yaml Type: Variable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -MaxVirtualMemory La memoria virtuale massima in byte. Al raggiungimento della soglia, il processo viene riavviato. Ignorato per l'ambiente integrato. ```yaml Type: Int64 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -RecycleSchedule Una pianificazione CRON per riavviare questo ambiente. Ignorata per l'ambiente integrato. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Una descrizione per questo ambiente. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DisableImplicitWinCompat Disabilita la modalità di compatibilità implicita di Windows PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Minimal Un ambiente minimo che non carica alcun modulo o variabile. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ProcessStartupScript Uno script che viene eseguito una volta all'avvio del processo. Non viene eseguito per ogni runspace. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Disabled L'ambiente è disabilitato. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Indica se il cmdlet deve ignorare i problemi relativi ai certificati. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Type Il tipo di ambiente. Sono supportati PowerShell 7 e Windows PowerShell 5.1. Utilizzare Custom per creare un ambiente personalizzato ```yaml Type: EnvironmentType Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Verb Il verbo da utilizzare durante la creazione del processo per questo ambiente. Non viene utilizzato per l'ambiente integrato. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Riutilizza e mantiene i cookie di autenticazione per la sessione PowerShell corrente. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable e -ProgressAction. Per maggiori informazioni, veda [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUT ### Nessuno ## OUTPUT ### System.Object ## NOTE ## LINK CORRELATI [New-PSUVariable](/powershell-universal/it/comandi-powershell/new-psuvariable.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/it/comandi-powershell/new-psuenvironment.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.