Descarga manual de paquetes

La Galería de PowerShell admite la descarga de un paquete desde el sitio web directamente, sin usar los cmdlets de PowerShellGet. Puede descargar cualquier paquete como un archivo de paquete NuGet (.nupkg), que luego puede copiar en un repositorio interno.

Nota

La descarga manual de paquetes no se diseñada como reemplazo del cmdlet Install-Module. La descarga del paquete no instala el módulo ni el script. Las dependencias no se incluyen en el paquete NuGet descargado. Las instrucciones siguientes solo se proporcionan con fines de referencia.

Uso de la descarga manual para adquirir un paquete

Cada página tiene un vínculo para Descarga manual, como se muestra aquí:

página de visualización del paquete de

Para descargar manualmente, haga clic en Descargar el archivo nupkg sin procesar. Se copia una copia del paquete en la carpeta de descarga del explorador con el nombre <name>.<version>.nupkg.

Un paquete NuGet es un archivo ZIP con archivos adicionales que contienen información sobre el contenido del paquete. Algunos exploradores, como Internet Explorer, reemplazan automáticamente la extensión de archivo .nupkg por .zip. Para expandir el paquete, cambie el nombre del archivo .nupkg a .zip, si es necesario, extraiga el contenido en una carpeta local mediante Expand-Archive o alguna otra herramienta de archivo ZIP.

Un archivo de paquete NuGet incluye los siguientes elementos específicos de NuGet que no forman parte del código empaquetado original:

• Una carpeta denominada _rels: contiene un archivo .rels que enumera las dependencias.
• Una carpeta denominada package: contiene los datos específicos de NuGet.
• Un archivo denominado [Content_Types].xml: describe cómo funcionan las extensiones como PowerShellGet con NuGet
• Un archivo denominado <name>.nuspec: contiene la mayor parte de los metadatos.

Instalación de módulos de PowerShell desde un paquete NuGet

Nota

Estas instrucciones NO dar el mismo resultado que la ejecución de Install-Module. Estas instrucciones cumplen los requisitos mínimos. No están diseñados para ser un reemplazo de Install-Module. No se incluyen algunos pasos realizados por Install-Module.

El enfoque más sencillo es quitar los elementos específicos de NuGet de la carpeta. Quitar los elementos deja el código de PowerShell creado por el autor del paquete. Para obtener la lista de elementos específicos de NuGet, consulte Uso de la descarga manual para adquirir un paquete.

Los pasos son los siguientes:

1. Desbloquee el archivo nuGet descargado de Internet (.nupkg), por ejemplo, mediante el cmdlet Unblock-File -Path C:\Downloads\module.nupkg.
2. Extraiga el contenido del paquete NuGet en una carpeta local.
3. Elimine los elementos específicos de NuGet de la carpeta.
4. Cambie el nombre de la carpeta. El nombre de carpeta predeterminado suele ser <name>.<version>. La versión puede incluir -prerelease si el módulo está etiquetado como una versión preliminar. Cambie el nombre de la carpeta a solo el nombre del módulo. Por ejemplo, azurerm.storage.5.0.4-preview se convierte en azurerm.storage.
5. Copie la carpeta en una de las carpetas de la $env:PSModulePath value. $env:PSModulePath es un conjunto de rutas de acceso delimitadas por punto y coma en las que PowerShell debe buscar módulos.

Importante

La descarga manual no incluye ninguna dependencia requerida por el módulo. Si el paquete tiene dependencias, deben instalarse en el sistema para que este módulo funcione correctamente. La Galería de PowerShell muestra todas las dependencias requeridas por el paquete.

Instalación de scripts de PowerShell desde un paquete NuGet

Nota

Estas instrucciones NO dar el mismo resultado que la ejecución de Install-Script. Estas instrucciones cumplen los requisitos mínimos. No están diseñados para ser un reemplazo de Install-Script.

El enfoque más sencillo es extraer el paquete NuGet y, a continuación, usar el script directamente.

Los pasos son los siguientes:

1. Desbloquee el archivo nuGet descargado de Internet (.nupkg), por ejemplo, mediante el cmdlet Unblock-File -Path C:\Downloads\package.nupkg.
2. Extraiga el contenido del paquete NuGet.
3. El archivo .PS1 de la carpeta se puede usar directamente desde esta ubicación.
4. Puede eliminar los elementos específicos de NuGet en la carpeta .

Para obtener la lista de elementos específicos de NuGet, consulte Uso de la descarga manual para adquirir un paquete.

Importante

La descarga manual no incluye ninguna dependencia requerida por el módulo. Si el paquete tiene dependencias, deben instalarse en el sistema para que este módulo funcione correctamente. La Galería de PowerShell muestra todas las dependencias requeridas por el paquete.