Galería

La Gallery es una colección de soluciones prediseñadas para PowerShell Universal. Incluye recursos como scripts, disparadores, aplicaciones y widgets. Es de código abierto, y los módulos se publican en la PowerShell Gallery. La PowerShell Universal Gallery proporciona una lista filtrada de recursos específicos de la plataforma.

Instalar recursos desde la galería

Página de la galería

La página de la galería descubre módulos de PowerShell Universal en la PowerShell Gallery. Almacenará los resultados en caché durante 5 minutos para mejorar el rendimiento.

Para instalar recursos desde la biblioteca, haga clic en Plataforma \ Galería en la consola de administración de Universal. Haga clic en el icono Instalar para guardar el recurso en su entorno. Cada solución es un módulo de PowerShell que se incluirá en el directorio de módulos de su repositorio.

Módulos en la galería

Los recursos instalados desde módulos, como los de la galería, se marcan como de solo lectura en la consola de administración.

Recurso de solo lectura en la consola de administración

Página del módulo

En la página del módulo, haga clic en Galerías y, a continuación, seleccione PSGallery para buscar y descargar recursos directamente desde el feed de la PowerShell Gallery. Deberá filtrar por la etiqueta PowerShellUniversalpara encontrar módulos específicos de la plataforma.

Desinstalar recursos

Una vez instalado un recurso, no puede eliminarlo a menos que elimine el propio módulo. Puede ir a la página Plataforma \ Módulos y hacer clic en la pestaña Módulos del repositorio para ver los módulos instalados desde la biblioteca.

Al hacer clic en el icono Eliminar se eliminará el módulo y todos los recursos asociados a él.

Módulos del repositorio

Contribuir a la galería

Puede aportar sus propios scripts a la PowerShell Universal Gallery. La PowerShell Universal Gallery localiza automáticamente los módulos de la PowerShell Gallery etiquetados con PowerShellUniversal. Si desea que su módulo aparezca en la PowerShell Universal Gallery y en PowerShell Universal, incluya esta etiqueta.

A continuación se muestra un ejemplo de un manifiesto del repositorio de la PowerShell Universal Gallery. Puede incluir una ruta de repositorio de GitHub como ProjectUri en el manifiesto. Si lo hace, el contenido del fichero README.md se representará en PowerShellUniversal.com.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
        }
    }
}

Módulos con licencia

Los módulos con licencia están actualmente en versión preliminar.

A partir de PowerShell Universal 5.2, ahora puede incluir una opción PSULicensed en la sección PSData del manifiesto de su módulo. Si el módulo tiene licencia, no se cargará sin un fichero de licencia específico del módulo que se está cargando. Actualmente, los ficheros de licencia los genera manualmente Ironman Software para los autores de módulos. Póngase en contacto con el soporte de Ironman Software para obtener más información.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
            PSULicensed = $true
        }
    }
}

Si se instala un módulo con licencia pero no se proporciona ninguna licencia, PowerShell Universal no cargará los recursos del módulo. Tenga en cuenta que cualquier función, alias y variable genéricos de PowerShell expuestos por el módulo estarán disponibles. Las aplicaciones, scripts, API u otras funciones de PowerShell Universal no se cargarán.

Actualmente, los módulos con licencia no proporcionan ningún mecanismo para ofuscar sus scripts de PowerShell ni para impedir que los usuarios eliminen el indicador de licencia. Recomendamos incluir un EULA estándar para garantizar que los usuarios sean legalmente responsables de manipular estos ficheros para eludir la licencia.