Install-PSResource

Modul:

Microsoft.PowerShell.PSResourceGet Module

Nainstaluje prostředky z registrovaného úložiště.

Syntaxe

NameParameterSet (Výchozí)

Install-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Tato rutina nainstaluje prostředky z registrovaného úložiště do instalační cesty na počítači. Rutina ve výchozím nastavení nevrací žádný objekt. Další parametry umožňují zadat úložiště, obor a verzi prostředku a potlačit výzvy k licenci.

Tato rutina kombinuje funkce Install-Module a rutin Install-Script z PowerShellGet v2.

Install-PSResource nenačte nově nainstalovaný modul do aktuální relace. Pokud chcete použít aktualizovaný modul, musíte naimportovat novou verzi nebo spustit novou relaci. Další informace najdete v tématu Import-Module .

Poznámka:

Install-PSResource neinstaluje závislé prostředky z úložišť, která používají protokol NuGet v3. Závislé prostředky musíte nainstalovat jednotlivě. Tuto funkci plánujeme přidat v budoucí verzi.

Příklady

Příklad 1

Nainstaluje nejnovější stabilní (nepřereleázní) verzi modulu Az z galerie Prostředí PowerShell.

Install-PSResource Az -Repository PSGallery

Modul Az je meta-modul, který zahrnuje všechny moduly Az PowerShellu jako závislosti. Tento příkaz nainstaluje modul Az a všechny jeho závislosti.

Příklad 2

Nainstaluje nejnovější stabilní modul Az Az mezi verzemi 7.3.0 a 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Příklad 3

Nainstaluje nejnovější stabilní verzi modulu Az. Když se použije parametr Přeinstalovat, rutina zapíše všechny dříve nainstalované verze.

Install-PSResource Az -Reinstall

Příklad 4

Nainstaluje psResources zadané v souboru psd1.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Příklad 5

Nainstaluje zdroje PSResource zadané v hashtable.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parametry

-AcceptLicense

Určuje, že prostředek by měl přijmout jakoukoli žádost o přijetí licenční smlouvy. To potlačí výzvu, pokud modul vyžaduje, aby uživatel přijal licenční smlouvu.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-AuthenticodeCheck

Ověřuje podpisy Authenticode a soubory katalogu ve Windows.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-Confirm

Před spuštěním cmdletu vá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

Volitelné přihlašovací údaje použité při přístupu k úložišti.

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:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Používá se pro vstup kanálu.

Vlastnosti parametru

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Rodičovský_zdroj

Sady parametrů

InputObjectParameterSet

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

-Name

Název jednoho nebo více prostředků, které se mají nainstalovat.

Vlastnosti parametru

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

Sady parametrů

NameParameterSet

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

-NoClobber

Zabrání instalaci balíčku obsahujícího rutiny, které už na počítači existují.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-PassThru

Při zadání výstupu PSResourceInfo objekt pro uložený prostředek.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-Prerelease

Pokud je zadáno, zahrne předběžné verze do vrácených výsledků hledání.

Vlastnosti parametru

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

Sady parametrů

NameParameterSet

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

-Quiet

Potlačí indikátor průběhu instalace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-Reinstall

Nainstaluje nejnovější verzi modulu, i když je už nainstalovaná nejnovější verze. Nainstalovaná verze se přepíše. To vám umožní opravit poškozenou instalaci modulu.

Pokud je nainstalovaná starší verze modulu, nová verze se nainstaluje vedle sebe do nové složky specifické pro verzi.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-Repository

Určuje jeden nebo více názvů úložišť, které se mají prohledávat. Pokud není zadáno, hledání zahrnuje všechna registrovaná úložiště v pořadí priority (nejvyšší jako první), dokud se nenajde úložiště obsahující balíček. Úložiště se seřadí podle priority a pak podle názvu. Nižší Priorita hodnoty mají vyšší prioritu.

Při hledání prostředků v různých úložištích RUTINy PSResourceGet prohledávají úložiště pomocí tohoto pořadí řazení. Install-PSResource nainstaluje první odpovídající balíček ze seřazeného seznamu úložišť.

Parametr podporuje * zástupný znak. Pokud zadáte více úložišť, musí všechny názvy obsahovat nebo vynechat zástupný znak. Nemůžete zadat kombinaci názvů se zástupnými znaky a bez zástupných znaků.

Vlastnosti parametru

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

Sady parametrů

NameParameterSet

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

InputObjectParameterSet

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

-RequiredResource

Hashtable nebo řetězec JSON, který určuje prostředky, které se mají nainstalovat. Zástupné znaky nejsou povolené. Popis formátů souborů najdete v části NOTES.

Vlastnosti parametru

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

Sady parametrů

RequiredResourceParameterSet

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

-RequiredResourceFile

Cesta k .psd1 nebo .json, která určuje prostředky, které se mají nainstalovat. Zástupné znaky nejsou povolené. Popis formátů souborů najdete v části NOTES.

Vlastnosti parametru

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

Sady parametrů

RequiredResourceFileParameterSet

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

-Scope

Určuje obor instalace. Přijaté hodnoty jsou:

• CurrentUser
• AllUsers

Výchozí obor je CurrentUser, který nevyžaduje zvýšení oprávnění pro instalaci.

Obor AllUsers nainstaluje moduly do umístění přístupného všem uživatelům počítače. Například:

• $env:ProgramFiles\PowerShell\Modules

CurrentUser nainstaluje moduly do umístění přístupného pouze aktuálnímu uživateli počítače. Například:

• $home\Documents\PowerShell\Modules

Vlastnosti parametru

Typ:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Default value:	None
Přípustné hodnoty:	CurrentUser, AllUsers
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

-SkipDependencyCheck

Přeskočí kontrolu závislostí prostředků. Jsou nainstalovány pouze nalezené prostředky. Nejsou nainstalovány žádné prostředky nalezeného prostředku.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-TemporaryPath

Určuje cestu k dočasné instalaci prostředku před skutečnou instalací. Pokud není k dispozici žádná dočasná cesta, prostředek se dočasně nainstaluje do dočasné složky aktuálního uživatele.

Vlastnosti parametru

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

-TrustRepository

Potlačí výzvy k důvěryhodnosti úložiště. Výzva k důvěryhodnosti úložiště se zobrazí pouze v případě, že úložiště není nakonfigurované jako důvěryhodné.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
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

-Version

Určuje verzi prostředku, která se má vrátit. Hodnota může být přesná verze nebo rozsah verzí pomocí syntaxe správy verzí NuGet.

Další informace o rozsazích verzí NuGet najdete v tématu Správa verzí balíčku.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0, protože verze nevolí verze 1.0.0.0 a vyšší (minimální včetně rozsahu). Místo toho se hodnota považuje za požadovanou verzi. Pokud chcete vyhledat minimální inkluzivní rozsah, použijte [1.0.0.0, ] jako rozsah verzí.

Vlastnosti parametru

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

Sady parametrů

NameParameterSet

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 příkaz 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

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Výstupy

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Rutina ve výchozím nastavení nevrací žádné objekty. Když se použije parametr PassThru, rutina vypíše objekt PSResourceInfo pro uložený prostředek.

Poznámky

Modul definuje isres jako alias pro Install-PSResource.

Parametry RequiredResource a RequiredResourceFile slouží k vyhledání PSResource objektů odpovídajících konkrétním kritériím. Kritéria hledání můžete zadat pomocí hashtable nebo objektu JSON. U parametru RequiredResourceFile se hodnota hashtable uloží do souboru .psd1 a objekt JSON se uloží do souboru .json. Další informace naleznete v tématu about_PSResourceGet.

Související odkazy

• Správa verzí balíčků
• Uninstall-PSResource