Save-Module

Module:

PowerShellGet Module

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

Syntax

NameAndPathParameterSet (Standaard)

Save-Module
    [-Name] <String[]>
    [-Path] <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameAndLiteralPathParameterSet

Save-Module
    [-Name] <String[]>
    -LiteralPath <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndLiteralPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet

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 in 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 de geregistreerde opslagplaatsen van de lokale computer weergeven. U kunt de Find-Module-cmdlet gebruiken om geregistreerde opslagplaatsen te doorzoeken.

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
• Prerelease-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 op te geven, PowerShellGet. De parameter Path geeft aan waar de gedownloade module moet worden opgeslagen. De parameter Repository geeft een geregistreerde opslagplaats op, PSGallery-. Nadat het downloaden is voltooid, wordt Get-ChildItem 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 MaximumVersionof 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 op te geven, PowerShellGet. De parameter Path geeft aan 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, wordt Get-ChildItem 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 op te geven, PowerShellGet. De parameter Repository geeft een geregistreerde opslagplaats op, PSGallery-. RequiredVersion geeft versie 1.6.5.

Het object wordt via de pijpleiding naar Save-Moduleverzonden. De parameter Path geeft aan waar de gedownloade module moet worden opgeslagen. Nadat het downloaden is voltooid, wordt Get-ChildItem de inhoud van Pad weergegeven waar de bestanden zijn opgeslagen.

Parameters

-AcceptLicense

Accepteer automatisch de gebruiksrechtovereenkomst als het pakket dit vereist.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-AllowPrerelease

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

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Confirm

Vraagt u om bevestiging voordat u de Save-Moduleuitvoert.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Cf

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Credential

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

Parametereigenschappen

Type:	PSCredential
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Force

Als de locatie die is opgegeven door de parameter Path niet bestaat, retourneert de cmdlet een fout. Met de parameter Force wordt het doelpad gemaakt.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-InputObject

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

Parametereigenschappen

Type:	PSObject[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

InputObjectAndLiteralPathParameterSet

Position:	0
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

InputObjectAndPathParameterSet

Position:	0
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-LiteralPath

Specificeert 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 escapereeksen.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	PSPath

Parametersets

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

InputObjectAndLiteralPathParameterSet

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Name

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

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	0
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	0
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Path

Hiermee geeft u de locatie op de lokale computer voor het opslaan van een opgeslagen module. Accepteert jokertekens.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	True
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	1
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

InputObjectAndPathParameterSet

Position:	1
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Proxy

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

Parametereigenschappen

Type:	Uri
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-ProxyCredential

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

Parametereigenschappen

Type:	PSCredential
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-RequiredVersion

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

NameAndPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

NameAndLiteralPathParameterSet

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-WhatIf

Laat zien wat er gebeurt als de Save-Module wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Wi

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.