El cmdlet Save-Module descarga un módulo y las dependencias de un repositorio registrado.
Save-Module descarga y guarda la versión más reciente de un módulo. Los archivos se guardan en una ruta de acceso especificada en el equipo local. El módulo no está instalado, pero el contenido está disponible para su inspección por parte de un administrador. A continuación, el módulo guardado se puede copiar en la ubicación adecuada $env:PSModulePath de la máquina sin conexión.
Get-PSRepository muestra los repositorios registrados del equipo local. Puede usar el cmdlet Find-Module para buscar repositorios registrados.
Los parámetros que toman números de versión del módulo esperan cadenas con formato de números de versión.
Los números de versión estándar tienen un formato de x.y.z donde x, y y z son números
Las versiones preliminares tienen un formato de x.y.z-<prerelease_label> donde la <prerelease_label> cadena arbitraria está asignada a esa versión.
Ejemplos
Ejemplo 1: Guardar un módulo
En este ejemplo, un módulo y sus dependencias se guardan en el equipo local.
usa el parámetro Name de para especificar el módulo, PowerShellGet. El parámetro Path especifica dónde almacenar el módulo descargado. El parámetro Repository de especifica un repositorio registrado, PSGallery. Una vez finalizada la descarga, Get-ChildItem muestra el contenido de Ruta de acceso donde se almacenan los archivos.
Ejemplo 2: Guardar una versión específica de un módulo
En este ejemplo se muestra cómo usar un parámetro como MaximumVersiono RequiredVersion para especificar una versión del módulo.
usa el parámetro Name de para especificar el módulo, PowerShellGet. El parámetro Path especifica dónde almacenar el módulo descargado. El parámetro Repository de especifica un repositorio registrado, PSGallery.
MaximumVersion especifica que la versión 2.1.0 se descarga y guarda. Una vez finalizada la descarga, Get-ChildItem muestra el contenido de Ruta de acceso donde se almacenan los archivos.
Ejemplo 3: Buscar y guardar una versión específica de un módulo
En este ejemplo, se encuentra una versión de módulo necesaria en el repositorio y se guarda en el equipo local.
usa el parámetro Name de para especificar el módulo, PowerShellGet. El parámetro Repository de especifica un repositorio registrado, PSGallery.
RequiredVersion especifica la versión 1.6.5.
El objeto se envía por la canalización a Save-Module. El parámetro Path especifica dónde almacenar el módulo descargado. Una vez finalizada la descarga, Get-ChildItem muestra el contenido de Ruta de acceso donde se almacenan los archivos.
Parámetros
-AcceptLicense
Acepte automáticamente el contrato de licencia si el paquete lo requiere.
Si la ubicación especificada por el parámetro Path no existe, el cmdlet devuelve un error.
El uso del parámetro Force crea la ruta de acceso de destino.
Especifica una ruta de acceso a una o varias ubicaciones. El valor del parámetro LiteralPath se usa exactamente como se ha especificado. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbalos entre comillas simples. PowerShell no interpreta ningún carácter entre comillas simples como secuencias de escape.
Especifica la versión máxima o más reciente del módulo que se va a guardar. Los parámetros MaximumVersion y RequiredVersion no se pueden usar en el mismo comando.
Especifica la versión mínima de un único módulo que se va a guardar. No puede agregar este parámetro si está intentando instalar varios módulos. Los parámetros MinimumVersion y RequiredVersion no se pueden usar en el mismo comando.
Especifica el nombre descriptivo de un repositorio que se ha registrado mediante la ejecución Register-PSRepositoryde . Use Get-PSRepository para mostrar repositorios registrados.
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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:
Para obtener más información, consulte el anuncio en el blog de PowerShell.
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
