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.

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

Parametry, které přebírají čísla verzí modulů, očekávají řetězce formátované jako čísla verzí.

Standardní čísla verzí mají formát x.y.z , kde x, y a z jsou čísla.
Předběžné verze mají formát x.y.z-<prerelease_label> , ve kterém <prerelease_label> je k dané verzi přiřazen libovolný řetězec.

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

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

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.

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

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

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.

Type:	String
Aliases:	PSPath
Position:	Named
Default value:	None
Required:	True
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
Required:	False
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
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

Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
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
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

Určuje přesné číslo verze modulu, který se má uložit.

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

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 o PowerShellu.

Sdílet prostřednictvím