Save-Module

Modul:

PowerShellGet Module

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

Syntax

NameAndPathParameterSet (Výchozí)

Save-Module
    [-Name] <String[]>
    -Path <String>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameAndLiteralPathParameterSet

Save-Module
    [-Name] <String[]>
    -LiteralPath <String>
    [-MinimumVersion <Version>]
    [-MaximumVersion <Version>]
    [-RequiredVersion <Version>]
    [-Repository <String[]>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndLiteralPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet

Save-Module
    [-InputObject] <PSObject[]>
    -Path <String>
    [-Force]
    [-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.

Get-PSRepository zobrazí zaregistrovaná úložiště místního počítače. K vyhledávání registrovaných úložišť můžete použít rutinu Find-Module.

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

-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

-Force

Vynutí Save-Module spuštění bez žádosti o potvrzení uživatele.

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.

Vlastnosti parametru

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

Sady parametrů

NameAndLiteralPathParameterSet

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

Vlastnosti parametru

Typ:	Version
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

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.

Vlastnosti parametru

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

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:	False
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:	False
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

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

Vlastnosti parametru

Typ:	Version
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.