Save-Module

Referencia

Módulo:: PowerShellGet

Guarda un módulo y sus dependencias en el equipo local, pero no instala el módulo.

Sintaxis

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Module
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

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 $env:PSModulePath adecuada 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.

Ejemplos

Ejemplo 1: Guardar un módulo

En este ejemplo, un módulo y sus dependencias se guardan en el equipo local.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules

Directory: C:\Test\Modules

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:31                PackageManagement
d-----         7/1/2019     13:31                PowerShellGet

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.

Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     13:40                2.1.0

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.

Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
  Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet

Directory: C:\Test\Modules\PowerShellGet

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----         7/1/2019     14:04                1.6.5

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 a la canalización para 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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowPrerelease

Permite guardar un módulo marcado como una versión preliminar.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el Save-Module.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica una cuenta de usuario que tiene derechos para guardar un módulo.

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Force

Obliga a Save-Module a ejecutarse sin pedir confirmación del usuario.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Acepta un objeto de PSRepositoryItemInfo. Por ejemplo, la salida a una variable y use esa variable como argumento inputObject .

Tipo:	PSObject[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor del parámetro LiteralPath se usa exactamente como se ha especificado. No se interpreta ningún carácter 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.

Tipo:	String
Alias:	PSPath
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MaximumVersion

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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MinimumVersion

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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica una matriz de nombres de módulos que se van a guardar.

Tipo:	String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Path

Especifica la ubicación en el equipo local para almacenar un módulo guardado. Acepta caracteres comodín.

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	True

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente al recurso de Internet.

Tipo:	Uri
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro proxy de .

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Repository

Especifica el nombre descriptivo de un repositorio que se ha registrado mediante la ejecución de Register-PSRepository. Use Get-PSRepository para mostrar repositorios registrados.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-RequiredVersion

Especifica el número de versión exacto del módulo que se va a guardar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecuta el Save-Module. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String[]

PSObject[]

String

Uri

PSCredential

Salidas

Object

Notas

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.SecurityProtocolType]::Tls12

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

Compartir a través de