Install-PSResource

  • Referentie
Module:
Microsoft.PowerShell.PSResourceGet

Hiermee worden resources geïnstalleerd vanuit een geregistreerde opslagplaats.

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

Met deze cmdlet worden resources van een geregistreerde opslagplaats naar een installatiepad op een computer geïnstalleerd. Standaard retourneert de cmdlet geen objecten. 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 cmdlets en Install-Script van PowerShellGet v2.

Voorbeelden

Voorbeeld 1

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

Install-PSResource Az

Voorbeeld 2

Installeert de meest recente 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 Reinstall 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 elke aanvraag voor het accepteren van de licentieovereenkomst moet accepteren. Hierdoor wordt niet gevraagd of de module een gebruiker verplicht de gebruiksrechtovereenkomst te accepteren.

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

-AuthenticodeCheck

Valideert authenticode-handtekeningen en catalogusbestanden in Windows.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Credential

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

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

-InputObject

Wordt gebruikt voor pijplijninvoer.

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

-Name

De naam van een of meer resources die moeten worden geïnstalleerd.

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

-NoClobber

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

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

-PassThru

Indien opgegeven, wordt een PSResourceInfo-object voor de opgeslagen resource uitgevoerd.

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

-Prerelease

Wanneer dit is opgegeven, worden voorlopige versies opgenomen in zoekresultaten die worden geretourneerd.

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

-Quiet

Onderdrukt de voortgangsbalk van de installatie.

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

-Reinstall

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

Als 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 volgorde van prioriteit (hoogste eerst), totdat er 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 met en zonder jokertekens opgeven.

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

-RequiredResource

Een hashtabel of JSON-tekenreeks die de resources aangeeft 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequiredResourceFile

Pad naar een .psd1 of .json waarin 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Hiermee geeft u het installatiebereik op. Geaccepteerde waarden zijn:

  • CurrentUser
  • AllUsers

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

Met AllUsers het bereik worden modules geïnstalleerd 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
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

Hiermee wordt de controle op resourceafhankelijkheden overgeslagen. Alleen gevonden resources worden geïnstalleerd. Er zijn geen resources van de gevonden resource geïnstalleerd.

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

-TemporaryPath

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

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

-TrustRepository

Vragen om de opslagplaats te vertrouwen onderdrukken. De prompt om de opslagplaats te vertrouwen wordt alleen weergegeven als de opslagplaats niet is geconfigureerd als vertrouwd.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 ondersteunt alle, behalve de minimale inclusief versie die wordt vermeld in de documentatie over het NuGet-versiebereik. Als 1.0.0.0 u als 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 als het versiebereik.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 het JSON-object in een .json bestand. Zie about_PSResourceGet voor meer informatie.