Delen via

Save-Module

  • Referentie
Module:
PowerShellGet

Slaat een module en de bijbehorende afhankelijkheden op de lokale computer op, maar installeert de module niet.

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

De Save-Module cmdlet downloadt een module en eventuele afhankelijkheden uit een geregistreerde opslagplaats. Save-Module downloadt en slaat de meest recente versie van een module op. De bestanden worden opgeslagen op een opgegeven pad op de lokale computer. De module is niet geïnstalleerd, maar de inhoud is beschikbaar voor inspectie door een beheerder. De opgeslagen module kan vervolgens worden gekopieerd naar de juiste $env:PSModulePath locatie van de offlinecomputer.

Dit is een proxy-cmdlet voor de Save-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Save-PSResource voor meer informatie

Voorbeelden

Voorbeeld 1: Een module opslaan

In dit voorbeeld worden een module en de bijbehorende afhankelijkheden opgeslagen op de lokale computer.

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 gebruikt de parameter Name om de module PowerShellGet op te geven. De path parameter geeft aan waar de gedownloade module moet worden opgeslagen. De parameter Opslagplaats geeft een geregistreerde opslagplaats, PSGallery, op. Nadat het downloaden is voltooid, Get-ChildItem wordt de inhoud van Pad weergegeven waar de bestanden zijn opgeslagen.

Voorbeeld 2: Een specifieke versie van een module opslaan

In dit voorbeeld ziet u hoe u een parameter zoals MaximumVersion of RequiredVersion gebruikt om een moduleversie op te geven.

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 gebruikt de parameter Name om de module PowerShellGet op te geven. De path parameter geeft aan waar de gedownloade module moet worden opgeslagen. De parameter Opslagplaats geeft een geregistreerde opslagplaats, PSGallery, op. MaximumVersion geeft aan dat versie 2.1.0 wordt gedownload en opgeslagen. Nadat het downloaden is voltooid, Get-ChildItem wordt de inhoud van Pad weergegeven waar de bestanden zijn opgeslagen.

Voorbeeld 3: een specifieke versie van een module zoeken en opslaan

In dit voorbeeld wordt een vereiste moduleversie gevonden in de opslagplaats en opgeslagen op de lokale computer.

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 gebruikt de parameter Name om de module PowerShellGet op te geven. De parameter Opslagplaats geeft een geregistreerde opslagplaats, PSGallery, op. RequiredVersion geeft versie 1.6.5 op.

Het object wordt door de pijplijn verzonden naar Save-Module. De path parameter geeft aan waar de gedownloade module moet worden opgeslagen. Nadat het downloaden is voltooid, Get-ChildItem wordt de inhoud van Pad weergegeven waar de bestanden zijn opgeslagen.

Parameters

-AcceptLicense

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Save-PSResource.

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

-AllowPrerelease

Hiermee kunt u een module opslaan die is gemarkeerd als een voorlopige versie.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Save-PSResource.

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

-Confirm

U wordt om bevestiging gevraagd voordat u de Save-Moduleuitvoert.

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

-Credential

Hiermee geeft u een gebruikersaccount op dat rechten heeft om een module op te slaan.

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

-Force

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Save-PSResource.

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

-InputObject

Accepteert een PSRepositoryItemInfo-object . Voer bijvoorbeeld uit Find-Module naar een variabele en gebruik die variabele als het argument InputObject .

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

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van de parameter LiteralPath wordt precies zoals opgegeven gebruikt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u deze tussen enkele aanhalingstekens. PowerShell interpreteert geen tekens tussen enkele aanhalingstekens als escape-reeksen.

De proxy-cmdlet wijst deze parameter toe aan de path-parameter van Save-PSResource.

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

-MaximumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Save-PSResource.

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

-MinimumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Save-PSResource.

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

-Name

Hiermee geeft u een matrix met namen van modules op om op te slaan.

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

-Path

Hiermee geeft u de locatie op de lokale computer om een opgeslagen module op te slaan. Accepteert jokertekens.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Save-PSResource.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Save-PSResource.

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

-Repository

Hiermee geeft u de beschrijvende naam van een opslagplaats die is geregistreerd door uit te voeren Register-PSRepository. Gebruik Get-PSRepository om geregistreerde opslagplaatsen weer te geven.

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

-RequiredVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Save-PSResource.

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

-WhatIf

Laat zien wat er zou gebeuren als de Save-Module uitvoeringen worden uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String[]

PSObject[]

String

Uri

PSCredential

Uitvoerwaarden

Object

Notities

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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