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