Delen via


Install-PSResource

Hiermee worden resources vanuit een geregistreerde opslagplaats geïnstalleerd.

Syntaxis

NameParameterSet (Standaard)

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>]

InputObjectParameterSet

Install-PSResource
    [-InputObject] <PSResourceInfo[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-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.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AuthenticodeCheck

Valideert Authenticode-handtekeningen en catalogusbestanden in Windows.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Credential

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

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Wordt gebruikt voor pijplijninvoer.

Parametereigenschappen

Type:

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Ouderlijke bron

Parametersets

InputObjectParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NoClobber

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Prerelease

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:IsPrerelease

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Quiet

Onderdrukt de voortgangsbalk van de installatie.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False
InputObjectParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-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.

Parametereigenschappen

Type:Object
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RequiredResourceParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

RequiredResourceFileParameterSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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

Parametereigenschappen

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Default value:None
Geaccepteerde waarden:CurrentUser, AllUsers
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SkipDependencyCheck

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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_PSResourceGetvoor meer informatie.