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.

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

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

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

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

-AllowPrerelease

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

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
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
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.

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

-MaximumVersion

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

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

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

-Proxy

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

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

-ProxyCredential

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

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

-RequiredVersion

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

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

Indata

String[]

PSObject[]

String

Uri

PSCredential

Utdata

Object

Kommentarer

Viktigt

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna 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 kontrollera att du använder TLS 1.2:

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

Mer information finns i tillkännagivandet i PowerShell-bloggen.