Save-Module

Referentie

Module:: PowerShellGet

Hiermee slaat u een module en de afhankelijkheden ervan op de lokale computer op, maar installeert u 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 doorzoeken.

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

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

Parameters

-AcceptLicense

Accepteer automatisch de gebruiksrechtovereenkomst als het pakket dit vereist.

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

-Confirm

U wordt gevraagd om bevestiging voordat u de opdracht uitvoert Save-Module.

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

-Credential

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

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

-Force

Dwingt Save-Module om te worden uitgevoerd zonder om bevestiging van de gebruiker te vragen.

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

-InputObject

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

Type:	PSObject[]
Position:	0
Default value:	None
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 exact gebruikt zoals opgegeven. 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.

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

Hiermee geeft u een matrix met namen van modules op die moeten worden opgeslagen.

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

-Path

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

Type:	String
Position:	1
Default value:	None
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 internetresource.

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

-ProxyCredential

Hiermee geeft u een gebruikersaccount met machtigingen voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

Type:	PSCredential
Position:	Named
Default value:	None
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 dit om geregistreerde opslagplaatsen weer te geven.

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

-RequiredVersion

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

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

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 het PowerShell-blog voor meer informatie.