Share via


Save-Module

Sparar en modul och dess beroenden på den lokala datorn men installerar inte modulen.

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

Cmdleten Save-Module laddar ned en modul och eventuella beroenden från en registrerad lagringsplats. Save-Module laddar ned och sparar den senaste versionen av en modul. Filerna sparas på en angiven sökväg på den lokala datorn. Modulen är inte installerad, men innehållet är tillgängligt för granskning av en administratör. Den sparade modulen kan sedan kopieras till lämplig $env:PSModulePath plats för offlinedatorn.

Det här är en proxy-cmdlet för Save-PSResource cmdleten i Microsoft.PowerShell.PSResourceGet. Mer information finns i Save-PSResource

Exempel

Exempel 1: Spara en modul

I det här exemplet sparas en modul och dess beroenden på den lokala datorn.

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 använder parametern Namn för att ange modulen PowerShellGet. Parametern Path anger var den nedladdade modulen ska lagras. Parametern Repository anger en registrerad lagringsplats, PSGallery. När nedladdningen är klar Get-ChildItem visas innehållet i Sökväg där filerna lagras.

Exempel 2: Spara en specifik version av en modul

Det här exemplet visar hur du använder en parameter som MaximumVersion eller RequiredVersion för att ange en modulversion.

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 använder parametern Namn för att ange modulen PowerShellGet. Parametern Path anger var den nedladdade modulen ska lagras. Parametern Repository anger en registrerad lagringsplats, PSGallery. MaximumVersion anger att version 2.1.0 laddas ned och sparas. När nedladdningen är klar Get-ChildItem visas innehållet i Sökväg där filerna lagras.

Exempel 3: Hitta och spara en specifik version av en modul

I det här exemplet finns en nödvändig modulversion på lagringsplatsen och sparas på den lokala datorn.

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 använder parametern Namn för att ange modulen PowerShellGet. Parametern Repository anger en registrerad lagringsplats, PSGallery. RequiredVersion anger version 1.6.5.

Objektet skickas ned pipelinen till Save-Module. Parametern Path anger var den nedladdade modulen ska lagras. När nedladdningen är klar Get-ChildItem visas innehållet i Sökväg där filerna lagras.

Parametrar

-AcceptLicense

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Save-PSResource.

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

-AllowPrerelease

Gör att du kan spara en modul som är markerad som en förhandsversion.

Proxy-cmdleten mappar den här parametern till parametern Prerelease för Save-PSResource.

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

-Confirm

Uppmanar dig att bekräfta innan du Save-Modulekör .

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

-Credential

Anger ett användarkonto som har behörighet att spara en modul.

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

-Force

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Save-PSResource.

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

-InputObject

Accepterar ett PSRepositoryItemInfo-objekt . Till exempel utdata Find-Module till en variabel och använd variabeln som InputObject-argument .

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

-LiteralPath

Anger en sökväg till en eller flera platser. Värdet för parametern LiteralPath används exakt som angetts. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du dem inom enkla citattecken. PowerShell tolkar inte några tecken som omges av enkla citattecken som escape-sekvenser.

Proxy-cmdleten mappar den här parametern till parametern Path för Save-PSResource.

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

-MaximumVersion

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Save-PSResource.

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

-MinimumVersion

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Save-PSResource.

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

-Name

Anger en matris med namn på moduler som ska sparas.

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

-Path

Anger platsen på den lokala datorn för att lagra en sparad modul. Accepterar jokertecken.

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

-Proxy

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Save-PSResource.

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

-ProxyCredential

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av Save-PSResource.

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

-Repository

Anger det egna namnet på en lagringsplats som har registrerats genom att köra Register-PSRepository. Använd Get-PSRepository för att visa registrerade lagringsplatser.

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

-RequiredVersion

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Save-PSResource.

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

-WhatIf

Visar vad som skulle hända om körningarna Save-Module . Cmdleten körs inte.

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

Indata

String[]

PSObject[]

String

Uri

PSCredential

Utdata

Object

Kommentarer

PowerShell-galleriet har inte längre stöd för TLS-versionerna 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att kontrollera att du använder TLS 1.2:

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