Compartir a través de

Introducción a la Galería de PowerShell

  • Artículo

La Galería de PowerShell es un repositorio de paquetes que contiene scripts, módulos y recursos de DSC que puede descargar y aprovechar. Use los cmdlets del módulo PowerShellGet para instalar paquetes desde la Galería de PowerShell. No es necesario iniciar sesión para descargar elementos de la Galería de PowerShell.

Nota

Es posible descargar un paquete directamente desde la Galería de PowerShell, pero no es un enfoque recomendado. Para obtener más información, consulte descarga manual de paquetes.

Puede encontrar paquetes en la Galería de PowerShell mediante el control buscar en la página principal de la Galería de PowerShello examinando los módulos y scripts de la página paquetes de . También puede encontrar paquetes desde la Galería de PowerShell ejecutando los cmdlets Find-Module, Find-DscResourcey Find-Script, según el tipo de paquete, con -Repository PSGallery.

Puede filtrar los resultados de la Galería mediante los parámetros siguientes:

  • Nombre
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Etiqueta
  • Incluye
  • DscResource
  • RoleCapability
  • Mandar
  • Filtro

Si solo le interesa detectar recursos específicos de DSC en la Galería, puede ejecutar el cmdlet Find-DscResource. Find-DscResource devuelve datos sobre los recursos de DSC contenidos en la Galería. Dado que los recursos de DSC siempre se entregan como parte de un módulo, debe ejecutar Install-Module para instalar esos recursos de DSC.

Una vez que haya identificado un paquete que le interese, puede que quiera obtener más información sobre él. Para ello, examine la página específica del paquete en la Galería. En esa página, podrá ver todos los metadatos cargados con el paquete. Microsoft no comprueba estos metadatos y no los proporciona el autor del paquete. El propietario del paquete está estrechamente vinculado a la cuenta de la galería que se usa para publicar el paquete y es más confiable que el campo Autor.

Si descubre un paquete que siente que no está publicado de buena fe, haga clic en Notificar abuso en la página del paquete.

Si ejecuta Find-Module o Find-Script, puede ver estos datos en el objeto PSGetModuleInfo devuelto . En el ejemplo siguiente se devuelven datos del módulo de PSReadLine de la Galería.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

Se recomienda el siguiente proceso al descargar paquetes desde la Galería de PowerShell:

Inspeccionar

Para descargar un paquete de la Galería para su inspección, ejecute el cmdlet Save-Module o Save-Script, en función del tipo de paquete. Esto le permite guardar el paquete localmente sin instalarlo e inspeccionar el contenido del paquete. Recuerde eliminar el paquete guardado manualmente.

Microsoft crea algunos de estos paquetes y la comunidad de PowerShell crea otros. Microsoft recomienda revisar el contenido y el código de los paquetes de esta galería antes de la instalación.

Si descubre un paquete que siente que no está publicado de buena fe, haga clic en Notificar abuso en la página del paquete.

Instalar

Para instalar un paquete desde la Galería para su uso, ejecute el cmdlet Install-Module o Install-Script, según el tipo de paquete.

Install-Module instala el módulo para $env:ProgramFiles\WindowsPowerShell\Modules de forma predeterminada. Esto requiere una cuenta de administrador. Si agrega el parámetro -Scope CurrentUser, el módulo se instala en $HOME\Documents\WindowsPowerShell\Modules .

Install-Script instala el script en $env:ProgramFiles\WindowsPowerShell\Scripts de forma predeterminada. Esto requiere una cuenta de administrador. Si agrega el parámetro -Scope CurrentUser, el script se instala en $HOME\Documents\WindowsPowerShell\Scripts .

De forma predeterminada, Install-Module y Install-Script instalan la versión más reciente de un paquete. Para instalar una versión anterior del paquete, agregue el parámetro -RequiredVersion.

Desplegar

Para implementar un paquete desde la Galería de PowerShell en Azure Automation, haga clic en Azure Automationy, a continuación, haga clic en Implementar en Azure Automation en la página de detalles del paquete. Se le redirigirá al Portal de administración de Azure donde inicia sesión con las credenciales de la cuenta de Azure. Tenga en cuenta que la implementación de paquetes con dependencias implementa todas las dependencias en Azure Automation. El botón "Implementar en Azure Automation" se puede deshabilitar agregando la etiqueta AzureAutomationNotSupported a los metadatos del paquete.

Para más información sobre Azure Automation, consulte la documentación de Azure Automation.

Para actualizar los paquetes instalados desde la Galería de PowerShell, ejecute el cmdlet Update-Module o Update-Script. Cuando se ejecuta sin parámetros adicionales, Update-Module intenta actualizar todos los módulos instalados mediante la ejecución de Install-Module. Para actualizar los módulos de forma selectiva, agregue el parámetro -Name.

De forma similar, cuando se ejecuta sin parámetros adicionales, Update-Script también intenta actualizar todos los scripts instalados mediante la ejecución de Install-Script. Para actualizar los scripts de forma selectiva, agregue el parámetro -Name.

Para averiguar qué módulos ha instalado desde la Galería de PowerShell, ejecute el cmdlet Get-InstalledModule. Este comando enumera todos los módulos que tiene en el sistema que se instalaron directamente desde la Galería de PowerShell.

Del mismo modo, para averiguar qué scripts ha instalado desde la Galería de PowerShell, ejecute el cmdlet Get-InstalledScript. Este comando enumera todos los scripts que tiene en el sistema que se instalaron directamente desde la Galería de PowerShell.

Estos nombres de host deben agregarse a las listas de permitidos que controlan el acceso desde la red.

Hosts necesarios para la detección y descarga de paquetes:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

Hosts necesarios al usar el sitio web de la Galería de PowerShell:

  • *.powershellgallery.com: sitio web
  • go.microsoft.com y aka.ms: servicios de redirección

Importante

A partir de abril de 2020, la Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o superior, recibirá un error al intentar acceder a la Galería de PowerShell. Use el comando siguiente para asegurarse de que usa TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Para obtener más información, consulte el anuncio en el blog de PowerShell.

  • Find-DscResource
  • Find-Module
  • Find-Script
  • Get-InstalledModule
  • Get-InstalledScript
  • Install-Module
  • Install-Script
  • Publish-Module
  • Publish-Script
  • Register-PSRepository
  • Save-Module
  • Save-Script
  • Update-Module
  • Update-Script