Delen via

Install-PSResource

  • Referentie
Module:
Microsoft.PowerShell.PSResourceGet

Hiermee worden resources vanuit een geregistreerde opslagplaats geïnstalleerd.

Syntaxis

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

Met deze cmdlet worden resources van een geregistreerde opslagplaats geïnstalleerd naar een installatiepad op een computer. Standaard retourneert de cmdlet geen object. Met andere parameters kunt u de opslagplaats, het bereik en de versie voor een resource opgeven en licentieprompts onderdrukken.

Deze cmdlet combineert de functies van de Install-Module en Install-Script cmdlets uit PowerShellGet v2.

Install-PSResource laadt de zojuist geïnstalleerde module niet in de huidige sessie. U moet de nieuwe versie importeren of een nieuwe sessie starten om de bijgewerkte module te kunnen gebruiken. Zie Import-Modulevoor meer informatie.

Notitie

Install-PSResource installeert geen afhankelijke resources uit opslagplaatsen die gebruikmaken van het NuGet v3-protocol. U moet de afhankelijke resources afzonderlijk installeren. We zijn van plan deze functie toe te voegen in een toekomstige release.

Voorbeelden

Voorbeeld 1

Installeert de meest recente stabiele (niet-voorlopige versie) van de Az-module vanuit de PowerShell Gallery.

Install-PSResource Az -Repository PSGallery

De Az-module is een metamodule die alle Az PowerShell-modules als afhankelijkheden bevat. Met deze opdracht worden de Az-module en alle bijbehorende afhankelijkheden geïnstalleerd.

Voorbeeld 2

Installeert de nieuwste stabiele Az-module tussen versies 7.3.0 en 8.3.0.

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

Voorbeeld 3

Installeert de nieuwste stabiele versie van de module Az. Wanneer de parameter Opnieuw installeren wordt gebruikt, schrijft de cmdlet over een eerder geïnstalleerde versie.

Install-PSResource Az -Reinstall

Voorbeeld 4

Installeert de PSResources die zijn opgegeven in het psd1-bestand.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Voorbeeld 5

Installeert de PSResources die zijn opgegeven in de hashtabel.

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 = @{}
}

Parameters

-AcceptLicense

Hiermee geeft u op dat de resource een aanvraag moet accepteren om de gebruiksrechtovereenkomst te accepteren. Dit onderdrukt het vragen of de module vereist dat een gebruiker de gebruiksrechtovereenkomst accepteert.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AuthenticodeCheck

Valideert Authenticode-handtekeningen en catalogusbestanden in Windows.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Optionele referenties die worden gebruikt bij het openen van een opslagplaats.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Wordt gebruikt voor pijplijninvoer.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliassen:ParentResource
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van een of meer resources die u wilt installeren.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoClobber

Hiermee voorkomt u dat u een pakket installeert dat cmdlets bevat die al op de computer aanwezig zijn.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Wanneer dit is opgegeven, wordt een PSResourceInfo--object uitgevoerd voor de opgeslagen resource.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Prerelease

Indien opgegeven, bevat voorlopige versies in zoekresultaten die worden geretourneerd.

Type:SwitchParameter
Aliassen:IsPrerelease
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Quiet

Onderdrukt de voortgangsbalk van de installatie.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Reinstall

Hiermee wordt de nieuwste versie van een module geïnstalleerd, zelfs als de nieuwste versie al is geïnstalleerd. De geïnstalleerde versie wordt overschreven. Hierdoor kunt u een beschadigde installatie van de module herstellen.

Als er een oudere versie van de module is geïnstalleerd, wordt de nieuwe versie naast elkaar geïnstalleerd in een nieuwe versiespecifieke map.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Repository

Hiermee geeft u een of meer namen van opslagplaatsen om te zoeken. Als dit niet is opgegeven, bevat de zoekopdracht alle geregistreerde opslagplaatsen, in prioriteitsvolgorde (hoogste eerst), totdat een opslagplaats wordt gevonden die het pakket bevat. Opslagplaatsen worden gesorteerd op prioriteit en vervolgens op naam. Lagere prioriteit waarden hebben een hogere prioriteit.

Wanneer u zoekt naar resources in meerdere opslagplaatsen, doorzoekt de PSResourceGet cmdlets de opslagplaatsen met behulp van deze sorteervolgorde. Install-PSResource installeert het eerste overeenkomende pakket uit de gesorteerde lijst met opslagplaatsen.

De parameter ondersteunt het * jokerteken. Als u meerdere opslagplaatsen opgeeft, moeten alle namen het jokerteken bevatten of weglaten. U kunt geen combinatie van namen opgeven met en zonder jokertekens.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-RequiredResource

Een hashtabel of JSON-tekenreeks waarmee resources worden opgegeven die moeten worden geïnstalleerd. Jokertekens zijn niet toegestaan. Zie de sectie NOTES voor een beschrijving van de bestandsindelingen.

Type:Object
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RequiredResourceFile

Pad naar een .psd1 of .json waarmee resources worden opgegeven die moeten worden geïnstalleerd. Jokertekens zijn niet toegestaan. Zie de sectie NOTES voor een beschrijving van de bestandsindelingen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Hiermee geeft u het installatiebereik. Geaccepteerde waarden zijn:

  • CurrentUser
  • AllUsers

Het standaardbereik is CurrentUser, waarvoor geen uitbreiding van de installatie is vereist.

Het bereik AllUsers installeert modules op een locatie die toegankelijk is voor alle gebruikers van de computer. Bijvoorbeeld:

  • $env:ProgramFiles\PowerShell\Modules

De CurrentUser installeert modules op een locatie die alleen toegankelijk is voor de huidige gebruiker van de computer. Bijvoorbeeld:

  • $home\Documents\PowerShell\Modules
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Geaccepteerde waarden:CurrentUser, AllUsers
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipDependencyCheck

Slaat de controle op resourceafhankelijkheden over. Alleen gevonden resources zijn geïnstalleerd. Er zijn geen resources van de gevonden resource geïnstalleerd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TemporaryPath

Hiermee geeft u het pad op om de resource tijdelijk te installeren vóór de daadwerkelijke installatie. Als er geen tijdelijk pad wordt opgegeven, wordt de resource tijdelijk geïnstalleerd in de tijdelijke map van de huidige gebruiker.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TrustRepository

Onderdrukt prompts om de opslagplaats te vertrouwen. De prompt om de opslagplaats te vertrouwen vindt alleen plaats als de opslagplaats niet is geconfigureerd als vertrouwd.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Version

Hiermee geeft u de versie van de resource die moet worden geretourneerd. De waarde kan een exacte versie of een versiebereik zijn met behulp van de nuGet-versiebeheersyntaxis.

Zie Package versioningvoor meer informatie over NuGet-versiebereiken.

PowerShellGet ondersteunt alle, maar de minimale, inclusieve versie vermeld in de documentatie van het NuGet-versiebereik. Het gebruik van 1.0.0.0 omdat de versie geen versies 1.0.0.0 en hoger oplevert (minimaal inclusief bereik). In plaats daarvan wordt de waarde beschouwd als de vereiste versie. Als u wilt zoeken naar een minimaal inclusief bereik, gebruikt u [1.0.0.0, ] als versiebereik.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Uitvoerwaarden

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Standaard retourneert de cmdlet geen objecten. Wanneer de parameter PassThru wordt gebruikt, voert de cmdlet een PSResourceInfo--object uit voor de opgeslagen resource.

Notities

De module definieert isres als een alias voor Install-PSResource.

De parameters RequiredResource en RequiredResourceFile worden gebruikt om PSResource--objecten te vinden die voldoen aan specifieke criteria. U kunt de zoekcriteria opgeven met behulp van een hashtabel of een JSON-object. Voor de parameter RequiredResourceFile wordt de hashtabel opgeslagen in een .psd1-bestand en wordt het JSON-object opgeslagen in een .json bestand. Zie about_PSResourceGetvoor meer informatie.