Compartir a través de


Save-Module

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.

Se trata de un cmdlet de proxy para el Save-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Save-PSResource.

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

El cmdlet de proxy omite este parámetro, ya que no es compatible con Save-PSResource.

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.

El cmdlet de proxy asigna este parámetro al parámetro versión preliminar de Save-PSResource.

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

El cmdlet de proxy omite este parámetro, ya que no es compatible con Save-PSResource.

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.

El cmdlet proxy asigna este parámetro al parámetro Path de Save-PSResource.

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

-MaximumVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet que se usará con el parámetro Version de Save-PSResource.

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

-MinimumVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet que se usará con el parámetro Version de Save-PSResource.

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

El cmdlet de proxy omite este parámetro, ya que no es compatible con Save-PSResource.

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

-ProxyCredential

El cmdlet de proxy omite este parámetro, ya que no es compatible con Save-PSResource.

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

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet que se usará con el parámetro Version de Save-PSResource.

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

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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