New-PSUEnvironment
SINOPSIS
Crea un nuevo entorno de PowerShell Universal.
SINTAXIS
New-PSUEnvironment -Name <String> [-Version <String>] [-Type <EnvironmentType>] [-Path <String>]
[-Arguments <String>] [-Modules <String[]>] [-Variables <String[]>] [-PSModulePath <String[]>]
[-StartupScript <String[]>] [-PersistentRunspace] [-RunspaceRecycling] [-MaxRunspaces <Int32>]
[-MaxVirtualMemory <Int64>] [-RecycleSchedule <String>] [-Credential <Variable>] [-Description <String>]
[-DisableImplicitWinCompat] [-Minimal] [-Disabled] [-ProcessStartupScript <String>] [-EnableDebugger]
[-Verb <String>] [-ComputerName <String>] [-AppToken <String>] [-UseDefaultCredentials] [-Integrated]
[-TrustCertificate] [-Cookies] [<CommonParameters>]DESCRIPCIÓN
Los entornos definen entornos de ejecución de PowerShell dentro de PowerShell Universal. Puede utilizarlos al ejecutar APIs, scripts, dashboards y los procesos de seguridad para la autenticación y la autorización.
Los entornos se almacenan en el fichero ./universal/environments.ps1.
También puede utilizar este cmdlet para crear entornos a través de la API REST.
EJEMPLOS
Ejemplo 1
Crea un nuevo entorno llamado 7.1 que utiliza pwsh.exe para ejecutar APIs, scripts o dashboards.
Ejemplo 2
Crea un nuevo entorno llamado 7.1 que utiliza el ejecutable pwsh.exe y establece la política de ejecución en ByPass.
Ejemplo 3
Crea un nuevo entorno que utiliza todas las variables definidas con New-PSUVariable.
Ejemplo 4
Crea un nuevo entorno que carga automáticamente el módulo ActiveDirectory.
Ejemplo 5
Crea un nuevo entorno que utiliza runspaces persistentes. Los runspaces persistentes se utilizan para APIs y no se restablecen entre cada ejecución.
PARÁMETROS
-AppToken
El AppToken que se utiliza 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.
-Arguments
Argumentos que se pasan al proceso de PowerShell al iniciar el entorno.
-ComputerName
Especifica el nombre del ordenador o la URL a la que se debe llamar al acceder a la API de gestión de PowerShell Universal. También puede utilizar Connect-PSUServer antes de llamar a este cmdlet para establecer el nombre del ordenador para toda la sesión.
-Modules
Módulos que se cargan automáticamente al crear nuevos runspaces en el entorno.
-Name
El nombre del entorno.
-PSModulePath
Rutas adicionales que se añaden al PSModulePath para el entorno.
-Path
La ruta al ejecutable de PowerShell.
-PersistentRunspace
Si se habilitan los runspaces persistentes. Esto solo se utiliza para APIs.
-Variables
Variables que se importan al runspace. Estas son variables definidas por New-PSUVariable.
-UseDefaultCredentials
Utilizar las credenciales predeterminadas al conectarse a la API de gestión
-Integrated
Ejecuta el comando internamente en lugar de utilizar la API de gestión. Solo funciona al ejecutar el script desde dentro de PowerShell Universal.
-StartupScript
Un script que se ejecuta al crear los runspaces en este entorno.
-Version
Un número de versión que mostrar.
-RunspaceRecycling
Si se reciclan los runspaces. Los runspaces se reciclarán (se eliminarán y se volverán a crear) después de un tiempo determinado o de un número de usos.
-MaxRunspaces
El número máximo de runspaces que se crean para este entorno.
-EnableDebugger
Habilita la función de depuración de PowerShell para este entorno.
-Credential
La credencial que se utiliza con este entorno
-MaxVirtualMemory
La memoria virtual máxima en bytes. Cuando se alcanza el umbral, el proceso se reinicia. Se ignora para el entorno integrado.
-RecycleSchedule
Una programación CRON para reiniciar este entorno. Se ignora para el entorno integrado.
-Description
Una descripción para este entorno.
-DisableImplicitWinCompat
Deshabilita el modo de compatibilidad implícita de Windows PowerShell.
-Minimal
Un entorno mínimo que no carga ningún módulo ni variable.
-ProcessStartupScript
Un script que se ejecuta una vez cuando se inicia el proceso. No se ejecuta para cada runspace.
-Disabled
El entorno está deshabilitado.
-TrustCertificate
Si el cmdlet debe ignorar los problemas de certificado.
-Type
El tipo de entorno. Se admiten PowerShell 7 y Windows PowerShell 5.1. Utilice Custom para crear un entorno personalizado
-Verb
El verbo que se utiliza al crear el proceso para este entorno. No se utiliza para el entorno integrado.
-Cookies
Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell.
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?