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. Ve výchozím nastavení rutina nevrací žádný objekt. Další parametry umožňují určit úložiště, obor a verzi prostředku a potlačit výzvy k licenci.

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

Příklady

Příklad 1

Nainstaluje nejnovější stabilní (bez předběžné verze) verze modulu Az .

Install-PSResource Az

Příklad 2

Nainstaluje nejnovější stabilní modul Az v rámci 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 . Při použití parametru Reinstall 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 psResources 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 všechny žádosti o přijetí licenční smlouvy. Tím se potlačí výzva, pokud modul vyžaduje, aby uživatel přijal licenční smlouvu.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthenticodeCheck

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoClobber

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Pokud je zadán, výstup PSResourceInfo objekt pro uložený prostředek.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Prerelease

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

Type:	SwitchParameter
Aliases:	IsPrerelease
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Quiet

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Reinstall

Nainstaluje nejnovější verzi modulu, i když už je nejnovější verze nainstalovaná. 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 konkrétní verzi.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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, bude hledání zahrnovat všechna registrovaná úložiště v pořadí priority (nejvyšší na prvním místě), dokud se nenajde úložiště, které obsahuje 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ů ve více ú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 z 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 znakůmi a bez zástupných znaků.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-RequiredResource

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

Type:	Object
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredResourceFile

Cesta k .psd1 nebo .json , která určuje prostředky k instalaci. Zástupné znaky nejsou povolené. Popis formátů souborů najdete v části POZNÁMKY .

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Určuje rozsah instalace. Akceptované hodnoty jsou:

CurrentUser
AllUsers

Výchozí obor je CurrentUser, který nevyžaduje zvýšení oprávnění k 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

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

$home\Documents\PowerShell\Modules

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencyCheck

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustRepository

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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 rozsahech 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 nedává verze 1.0.0.0 a vyšší (minimální rozsah včetně). 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í.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	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

Ve výchozím nastavení rutina nevrací žádné objekty. Při použití parametru PassThru rutina vypíše objekt PSResourceInfo pro uložený prostředek.

Poznámky

Modul se isres definuje jako alias pro Install-PSResource.

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

Install-PSResource

Syntax

Description

Příklady

Příklad 1

Příklad 2

Příklad 3

Příklad 4

Příklad 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Vstupy

Výstupy

Poznámky

Váš názor

Další materiály

Install-PSResource

Syntax

Description

Příklady

Příklad 1

Příklad 2

Příklad 3

Příklad 4

Příklad 5

Parametry

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Vstupy

Výstupy

Poznámky

Související odkazy

Váš názor

Další materiály