Sdílet prostřednictvím

Install-PSResource

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

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

Syntax

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
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Typ:SwitchParameter
Aliases:cf
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Typ:PSCredential
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Typ:String[]
Position:0
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-NoClobber

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

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

Typ:SwitchParameter
Aliases:IsPrerelease
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Quiet

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

Typ:SwitchParameter
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:False
Accept wildcard characters: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řijímané hodnoty:CurrentUser, AllUsers
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Typ:SwitchParameter
Aliases:wi
Position:Named
výchozí hodnota:False
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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.