Save-Module

Referencia

Módulo:: PowerShellGet

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

Syntax

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 Save-Module cmdlet 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. Después, 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 Find-Module cmdlet 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.

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

Save-Module usa el parámetro Name para especificar el módulo PowerShellGet. El parámetro Path especifica dónde almacenar el módulo descargado. El parámetro Repository especifica un repositorio registrado, PSGallery. Una vez finalizada la descarga, Get-ChildItem muestra el contenido de Path 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 MaximumVersion o 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

Save-Module usa el parámetro Name para especificar el módulo PowerShellGet. El parámetro Path especifica dónde almacenar el módulo descargado. El parámetro Repository 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 Path 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

Find-Module usa el parámetro Name para especificar el módulo PowerShellGet. El parámetro Repository 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 Path donde se almacenan los archivos.

Parámetros

-AcceptLicense

Acepte automáticamente el contrato de licencia si el paquete lo requiere.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrerelease

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Acepta un objeto PSRepositoryItemInfo . Por ejemplo, la salida Find-Module a una variable y usarla como argumento InputObject .

Type:	PSObject[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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. 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.

Type:	String
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ProxyCredential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RequiredVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String[]

PSObject[]

String

Uri

PSCredential

Salidas

Object

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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

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

Compartir a través de