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 van 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-Module voor meer informatie.

Voorbeelden

Voorbeeld 1

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

Install-PSResource Az

Voorbeeld 2

Installeert de nieuwste stabiele Az-module binnen de 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 Az-module . 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

Hiermee wordt u 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. Waarden met een lagere prioriteit hebben een hogere prioriteit.

Bij het zoeken naar resources in meerdere opslagplaatsen doorzoeken 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 benodigde bevoegdheden nodig zijn voor installatie.

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

  • $env:ProgramFiles\PowerShell\Modules

De CurrentUser modules worden geïnstalleerd op een locatie die alleen toegankelijk is voor de huidige gebruiker van de computer. Voorbeeld:

  • $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 Pakketversiebeheer voor meer informatie over NuGet-versiebereiken.

PowerShellGet biedt ondersteuning voor alle, maar de minimaal inbegrepen versie die wordt vermeld in de documentatie van het NuGet-versiebereik. Als 1.0.0.0 u de versie gebruikt, levert geen versies 1.0.0.0 en hoger op (minimaal inclusief bereik). In plaats daarvan wordt de waarde beschouwd als de vereiste versie. Als u wilt zoeken naar een minimaal inclusief bereik, gebruikt [1.0.0.0, ] u deze als versiebereik.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String[]

String

SwitchParameter

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_PSResourceGet voor meer informatie.