Save-Module

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

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 ukládají do zadané cesty v místním počítači. Modul není nainstalovaný, ale obsah je k dispozici pro kontrolu správcem. Uložený modul se pak dá zkopírovat do příslušného $env:PSModulePath umístění offline počítače.

Get-PSRepository zobrazí zaregistrovaná úložiště místního počítače. Pomocí této rutiny Find-Module můžete prohledávat zaregistrovaná úložiště.

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žívá parametr Name k určení 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í se zobrazí obsah cesty, Get-ChildItem ve kterém 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žívá parametr Name k určení 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 se stáhne a uloží verze 2.1.0 . Po dokončení stahování se zobrazí obsah cesty, Get-ChildItem ve kterém 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 nachází 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žívá parametr Name k určení 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í se zobrazí obsah cesty, Get-ChildItem ve kterém jsou soubory uložené.

Parametry

-AcceptLicense

Pokud balíček vyžaduje, automaticky přijměte licenční smlouvu.

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

-AllowPrerelease

Umožňuje uložit modul označený jako předběžná verze.

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

-Confirm

Před spuštěním příkazu Save-Modulevás vyzve k potvrzení .

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

-Force

Pokud umístění zadané parametrem Path neexistuje, vrátí rutina chybu. Pomocí parametru Force se vytvoří cílová cesta.

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

-InputObject

Přijímá objekt PSRepositoryItemInfo . Například výstup Find-Module proměnné a použití této proměnné jako argumentu InputObject .

Type:PSObject[]
Position:0
Default value:None
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án. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete je do jednoduchých uvozovek. PowerShell interpretuje žádné znaky uzavřené v jednoduchých uvozovkách jako řídicí sekvence.

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

-MaximumVersion

Určuje maximální nebo nejnovější verzi modulu, která se má uložit. Parametry MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-MinimumVersion

Určuje minimální verzi jednoho modulu, který se má uložit. Tento parametr nelze přidat, pokud se pokoušíte nainstalovat více modulů. Parametry MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-Proxy

Určuje proxy server pro požadavek, a ne připojení přímo k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy .

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

-Repository

Určuje popisný název úložiště, které bylo zaregistrováno spuštěním Register-PSRepositorypříkazu . Slouží Get-PSRepository k zobrazení registrovaných úložišť.

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

-RequiredVersion

Určuje přesný počet verzí modulu, který chcete uložit.

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

-WhatIf

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

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

Vstupy

String[]

PSObject[]

String

Uri

PSCredential

Výstupy

Object

Poznámky

Důležité

Od dubna 2020 už Galerie prostředí PowerShell nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v oznámení na blogu PowerShellu.