Sdílet prostřednictvím

Install-PSResource

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

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

Syntaxe

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>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-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 Install-Script rutiny z modulu 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.

Příklady

Příklad 1

Nainstaluje nejnovější stabilní (nepřereleázní) verzi modulu Az .

Install-PSResource Az

Příklad 2

Nainstaluje nejnovější stabilní modul 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řeinstalace, 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.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AuthenticodeCheck

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

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

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

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliasy:ParentResource
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoClobber

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

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Prerelease

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

Typ:SwitchParameter
Aliasy:IsPrerelease
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Quiet

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

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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. Hodnoty s nižší prioritou mají vyšší prioritu.

Při hledání prostředků v různých úložištích prohledávají rutiny PSResourceGet ú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ů.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

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

Typ:Object
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RequiredResourceFile

Cesta k .psd1 prostředku .json , který se má nainstalovat. Zástupné znaky nejsou povolené. Popis formátů souborů najdete v části NOTES.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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. Příklad:

  • $env:ProgramFiles\PowerShell\Modules

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

  • $home\Documents\PowerShell\Modules
Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Přípustné hodnoty:CurrentUser, AllUsers
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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é.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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íčků.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0 jako verze nepřináší 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, ] ho jako rozsah verzí.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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í objektů PSResource 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 je hashtable uložen v .psd1 souboru a objekt JSON je uložen v .json souboru. Další informace najdete v tématu about_PSResourceGet.