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.

Get-PSRepository geeft de geregistreerde opslagplaatsen van de lokale computer weer. U kunt de Find-Module cmdlet gebruiken om geregistreerde opslagplaatsen te zoeken.

De parameters die moduleversienummers gebruiken, verwachten tekenreeksen die zijn opgemaakt als versienummers.

Standaardversienummers hebben een notatie waarbij x.y.z x, y en z getallen zijn
Voorlopige versies hebben een indeling waarin x.y.z-<prerelease_label> de <prerelease_label> willekeurige tekenreeks is toegewezen aan die release.

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. Met de parameter Path geeft u op waar de gedownloade module moet worden opgeslagen. De parameter Repository geeft een geregistreerde opslagplaats op, PSGallery. Nadat het downloaden is voltooid, Get-ChildItem wordt de inhoud weergegeven van Pad 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. Met de parameter Path geeft u op waar de gedownloade module moet worden opgeslagen. De parameter Repository geeft een geregistreerde opslagplaats op, PSGallery. MaximumVersion geeft aan dat versie 2.1.0 wordt gedownload en opgeslagen. Nadat het downloaden is voltooid, Get-ChildItem wordt de inhoud weergegeven van Pad 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 Repository geeft een geregistreerde opslagplaats op, PSGallery. RequiredVersion geeft versie 1.6.5 op.

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

Parameters

-AcceptLicense

Accepteer automatisch de gebruiksrechtovereenkomst als het pakket dit vereist.

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.

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

-Confirm

Vraagt u om bevestiging 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

Als de locatie die is opgegeven door de path-parameter niet bestaat, retourneert de cmdlet een fout. Met behulp van de parameter Force maakt u het doelpad.

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. Geen tekens worden geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, plaatst u deze tussen enkele aanhalingstekens. In PowerShell worden tekens tussen enkele aanhalingstekens niet geïnterpreteerd als escape-reeksen.

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

-MaximumVersion

Hiermee geeft u de maximale of nieuwste versie van de module die moet worden opgeslagen. De parameters MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

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

-MinimumVersion

Hiermee geeft u de minimale versie van één module op om op te slaan. U kunt deze parameter niet toevoegen als u meerdere modules wilt installeren. De parameters MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

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 die moeten worden opgeslagen.

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

Hiermee geeft u een proxyserver voor de aanvraag, in plaats van rechtstreeks verbinding te maken met de internetbron.

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

-ProxyCredential

Hiermee geeft u een gebruikersaccount op dat is gemachtigd voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

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

-Repository

Hiermee geeft u de beschrijvende naam op 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

Hiermee geeft u het exacte versienummer op van de module die moet worden opgeslagen.

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

-WhatIf

Hier ziet u wat er gebeurt 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

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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

Zie de aankondiging in de PowerShell-blog voor meer informatie.