Sdílet prostřednictvím

Save-Module

  • Reference
Modul:
PowerShellGet

Uloží modul a jeho závislosti na místním počítači, ale nenainstaluje ho.

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

Rutina Save-Module stáhne modul a všechny závislosti z registrovaného úložiště. Save-Module stáhne a uloží nejnovější verzi modulu. Soubory se uloží do zadané cesty v místním počítači. Modul není nainstalovaný, ale obsah je k dispozici ke kontrole správce. Uložený modul se pak dá zkopírovat do příslušného $env:PSModulePath umístění offline počítače.

Toto je rutina proxy pro rutinu Save-PSResource v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Save-PSResource.

Příklady

Příklad 1: Uložení modulu

V tomto příkladu se modul a jeho závislosti uloží do místního počítače.

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 použije parametr Name k zadání modulu , PowerShellGet. Parametr Path určuje, kam se má stažený modul uložit. Parametr Repository určuje registrované úložiště PSGallery. Po dokončení stahování zobrazí obsah cesty, Get-ChildItem kde jsou soubory uložené.

Příklad 2: Uložení konkrétní verze modulu

Tento příklad ukazuje, jak použít parametr, jako je MaximumVersion nebo RequiredVersion k určení verze modulu.

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 použije parametr Name k zadání modulu , PowerShellGet. Parametr Path určuje, kam se má stažený modul uložit. Parametr Repository určuje registrované úložiště PSGallery. MaximumVersion určuje, že verze 2.1.0 se stáhne a uloží. Po dokončení stahování zobrazí obsah cesty, Get-ChildItem kde jsou soubory uložené.

Příklad 3: Vyhledání a uložení konkrétní verze modulu

V tomto příkladu se v úložišti najde požadovaná verze modulu a uloží se do místního počítače.

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 použije parametr Name k zadání modulu , PowerShellGet. Parametr Repository určuje registrované úložiště PSGallery. RequiredVersion určuje verzi 1.6.5.

Objekt se odešle do kanálu .Save-Module Parametr Path určuje, kam se má stažený modul uložit. Po dokončení stahování zobrazí obsah cesty, Get-ChildItem kde jsou soubory uložené.

Parametry

-AcceptLicense

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Save-PSResource.

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

-AllowPrerelease

Umožňuje uložit modul označený jako předběžnou verzi.

Rutina proxy serveru mapuje tento parametr na parametr Prerelease parametru .Save-PSResource

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

-Confirm

Zobrazí výzvu k potvrzení před spuštěním nástroje Save-Module.

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

-Credential

Určuje uživatelský účet, který má práva k uložení modulu.

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

-Force

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Save-PSResource.

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

-InputObject

Přijímá objekt PSRepositoryItemInfo . Například výstup Find-Module do proměnné a použít tuto proměnnou jako argument InputObject .

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

-LiteralPath

Určuje cestu k jednomu nebo více umístěním. Hodnota parametru LiteralPath se používá přesně tak, jak je zadáno. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete je do jednoduchých uvozovek. PowerShell neinterpretuje žádné znaky uzavřené v jednoduchých uvozovkách jako řídicí sekvence.

Rutina proxy namapuje tento parametr na parametr Path pro Save-PSResource.

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

-MaximumVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version parametru .Save-PSResource

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

-MinimumVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version parametru .Save-PSResource

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

-Name

Určuje pole názvů modulů, které se mají uložit.

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

-Path

Určuje umístění v místním počítači pro uložení uloženého modulu. Přijímá zástupné znaky.

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

-Proxy

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Save-PSResource.

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje Save-PSResource.

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

-Repository

Určuje popisný název úložiště zaregistrovaného spuštěním příkazu Register-PSRepository. Slouží Get-PSRepository k zobrazení registrovaných úložišť.

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

-RequiredVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version parametru .Save-PSResource

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

-WhatIf

Ukazuje, co by se stalo, když se Save-Module spustí. Rutina se nespustí.

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

Vstupy

String[]

PSObject[]

String

Uri

PSCredential

Výstupy

Object

Poznámky

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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