Save-Module

Modul:

PowerShellGet v3 Module

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

Syntaxe

NameAndPathParameterSet (Výchozí)

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

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

Toto je rutina proxy pro tuto rutinu Save-PSResource v modulu Microsoft.PowerShell.PSResourceGet. Další informace naleznete 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 pomocí parametru Name specifikuje modul PowerShellGet. Parametr Path určuje, kam se má stažený modul uložit. Parametr úložiště určuje registrované úložiště PSGallery. Po dokončení stahování Get-ChildItem zobrazí obsah cesty , kde jsou soubory uloženy.

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

Tento příklad ukazuje, jak použít parametr, například MaximumVersion, nebo RequiredVersion zadat verzi 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 pomocí parametru Name specifikuje modul PowerShellGet. Parametr Path určuje, kam se má stažený modul uložit. Parametr úložiště 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í Get-ChildItem zobrazí obsah cesty , kde jsou soubory uloženy.

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 pomocí parametru Name specifikuje modul PowerShellGet. Parametr úložiště určuje registrované úložiště PSGallery. RequiredVersion určuje verze 1.6.5.

Objekt je odeslán potrubím do Save-Module. Parametr Path určuje, kam se má stažený modul uložit. Po dokončení stahování Get-ChildItem zobrazí obsah cesty , kde jsou soubory uloženy.

Parametry

-AcceptLicense

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllowPrerelease

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

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Credential

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

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Force

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

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

Vlastnosti parametru

Typ:	PSObject[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

InputObjectAndLiteralPathParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

InputObjectAndPathParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-LiteralPath

Určuje cestu k jednomu nebo více místům. Hodnota parametru LiteralPath se používá přesně tak, jak je zadán. Žádný znak není interpretován jako zástupný znak. 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 mapuje tento parametr na parametr Path parametru Save-PSResource.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	PSPath

Sady parametrů

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

InputObjectAndLiteralPathParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-MinimumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

InputObjectAndPathParameterSet

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Proxy

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

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyCredential

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

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Repository

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RequiredVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NameAndPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

NameAndLiteralPathParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se Save-Module spustí. Cmdlet se nespustil.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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 vyšší. 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