Save-Module

Modul:

PowerShellGet Module

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

Syntax

NameAndPathParameterSet (Standard)

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>]

Beskrivning

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.

Get-PSRepository visar den lokala datorns registrerade lagringsplatser. Du kan använda cmdleten Find-Module för att söka efter registrerade lagringsplatser.

Parametrarna som tar modulversionsnummer förväntar sig strängar som formateras som versionsnummer.

• Standardversionsnummer x.y.z har ett format där x, y och z är tal
• Förhandsversioner har ett format x.y.z-<prerelease_label> där <prerelease_label> är godtycklig sträng tilldelad till den versionen.

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 Name 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 visar Get-ChildItem innehållet i Path 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 MaximumVersioneller 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 Name 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 visar Get-ChildItem innehållet i Path 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 Name för att ange modulen PowerShellGet. Parametern Repository anger en registrerad lagringsplats PSGallery. RequiredVersion anger version 1.6.5.

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

Parametrar

-AcceptLicense

Godkänn licensavtalet automatiskt om paketet kräver det.

Egenskaper för parameter

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-AllowPrerelease

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

Egenskaper för parameter

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Confirm

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

Egenskaper för parameter

Typ:	SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False
Alias:	jfr

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Credential

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

Egenskaper för parameter

Typ:	PSCredential
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Force

Om den plats som anges av sökvägsparametern inte finns returnerar cmdleten ett fel. Med hjälp av parametern Force skapas målsökvägen.

Egenskaper för parameter

Typ:	SwitchParameter
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-InputObject

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

Egenskaper för parameter

Typ:	PSObject[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

InputObjectAndLiteralPathParameterSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

InputObjectAndPathParameterSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	True
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	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 wildcards. 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.

Egenskaper för parameter

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	PSPath

Parameteruppsättningar

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

InputObjectAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-MaximumVersion

Anger den maximala eller senaste versionen av modulen som ska sparas. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.

Egenskaper för parameter

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-MinimumVersion

Anger den lägsta versionen av en enskild modul som ska sparas. Du kan inte lägga till den här parametern om du försöker installera flera moduler. Parametrarna MinimumVersion och RequiredVersion kan inte användas i samma kommando.

Egenskaper för parameter

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Name

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

Egenskaper för parameter

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	0
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Path

Anger platsen på den lokala datorn där en sparad modul ska lagras. Accepterar jokertecken.

Egenskaper för parameter

Typ:	String
Standardvärde:	None
Stöder jokertecken:	True
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	1
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

InputObjectAndPathParameterSet

Position:	1
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

Egenskaper för parameter

Typ:	Uri
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

Egenskaper för parameter

Typ:	PSCredential
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	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.

Egenskaper för parameter

Typ:	String[]
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-RequiredVersion

Anger det exakta versionsnumret för modulen som ska sparas.

Egenskaper för parameter

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

NameAndPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

NameAndLiteralPathParameterSet

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-WhatIf

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

Egenskaper för parameter

Typ:	SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False
Alias:	Wi

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Ingångar

String

PSObject

String

Uri

PSCredential

Utgångar

Object

Anteckningar

Viktigt!

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:

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

Mer information finns i meddelande i PowerShell-bloggen.