Sdílet prostřednictvím

Update-PSResource

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

Stáhne a nainstaluje nejnovější verzi balíčku, která už je nainstalovaná na místním počítači.

Syntaxe

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

Description

Update-PSResource stáhne a nainstaluje nejnovější verzi balíčku, která už je nainstalovaná na místním počítači. Tato rutina Update-Module nahrazuje rutiny Update-Script z modulu PowerShellGet verze 2. Nová verze prostředku se instaluje souběžně s předchozími verzemi v nové složce s verzí.

Ve výchozím nastavení Update-PSResource nainstaluje nejnovější verzi balíčku a všechny její závislosti bez odstranění nainstalovaných starších verzí. Neexistuje žádný příkaz k odinstalaci starších verzí balíčku. Soubory a složky starších verzí musíte odstranit ručně.

Update-PSResource nenačte aktualizovaný 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

V tomto příkladu už má uživatel nainstalovaný balíček TestModule a aktualizuje balíček.

Get-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.2.0                                        test

Update-PSResource -Name "TestModule"

Name                                    Version                         Prerelease   Description
----                                    -------                         ----------   -----------
TestModule                              1.3.0                                        test
TestModule                              1.2.0                                        test

Parametry

-AcceptLicense

U prostředků, které vyžadují licenci, acceptLicense automaticky přijme licenční smlouvu během aktualizace.

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 podepsané soubory 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

Určuje volitelné přihlašovací údaje použité při přístupu k privátnímu ú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

-Force

Po zadání obchází kontroly TrustRepository a AcceptLicense a aktualizuje balíček.

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

-Name

Určuje název jednoho nebo více prostředků, které se mají aktualizovat. Zástupné znaky jsou podporované, ale NuGet tento znak přijímá * pouze. NuGet nepodporuje vyhledávání zástupných znaků místních (souborových) úložišť.

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

-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

Po zadání umožňuje aktualizaci na předběžnou verzi.

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

-Quiet

Potlačí informace o průběhu.

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í. Update-PSResource aktualizuje 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:False
Přijmout zástupné znaky:True

-Scope

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

  • CurrentUser
  • AllUsers

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

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ů. To znamená, že se aktualizují pouze pojmenované prostředky.

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

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 udres jako alias pro Update-PSResource.