Delen via

Install-PackageProvider

  • Referentie
Module:
PackageManagement

Hiermee installeert u een of meer pakketbeheerpakketproviders.

Syntax

Install-PackageProvider
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Source <String[]>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PackageProvider
       [-Scope <String>]
       [-InputObject] <SoftwareIdentity[]>
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Met de Install-PackageProvider cmdlet worden overeenkomende pakketbeheerproviders geïnstalleerd die beschikbaar zijn in pakketbronnen die zijn geregistreerd bij PowerShellGet. Standaard bevat dit modules die beschikbaar zijn in de Windows PowerShell Gallery met de tag PackageManagement. De PowerShellGet Package Management-provider wordt gebruikt voor het zoeken naar providers in deze opslagplaatsen.

Met deze cmdlet worden ook overeenkomende pakketbeheerproviders geïnstalleerd die beschikbaar zijn met behulp van de pakketbeheerbootstrapping-toepassing.

Met deze cmdlet worden ook overeenkomende pakketbeheerproviders geïnstalleerd die beschikbaar zijn in het Azure Blob-archief voor pakketbeheer. Gebruik de bootstrapper-provider om deze te zoeken en te installeren.

Om de eerste keer uit te voeren, heeft PackageManagement een internetverbinding nodig om de NuGet-pakketprovider te downloaden. Als uw computer echter geen internetverbinding heeft en u de NuGet- of PowerShellGet-provider moet gebruiken, kunt u deze downloaden naar een andere computer en naar uw doelcomputer kopiëren. Gebruik de volgende stappen om dit te doen:

  1. Voer uit Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force om de provider te installeren vanaf een computer met een internetverbinding.
  2. Na de installatie vindt u de provider die is geïnstalleerd in $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> of $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. Plaats de <ProviderName> map, in dit geval de NuGet-map, op de bijbehorende locatie op uw doelcomputer. Als uw doelcomputer een Nano-server is, moet u uitvoeren Install-PackageProvider vanuit Nano Server om de juiste binaire NuGet-bestanden te downloaden.
  4. Start PowerShell opnieuw op om de pakketprovider automatisch te laden. U kunt ook uitvoeren Get-PackageProvider -ListAvailable om alle pakketproviders weer te geven die beschikbaar zijn op de computer. Gebruik Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 vervolgens om de provider te importeren in de huidige Windows PowerShell sessie.

Voorbeelden

Met deze opdracht installeert u de Pakketprovider GistProvider vanuit de PowerShell Gallery.

Install-PackageProvider -Name "GistProvider" -Verbose

Voorbeeld 2: Een opgegeven versie van een pakketprovider installeren

In dit voorbeeld wordt een opgegeven versie van de NuGet-pakketprovider geïnstalleerd.

Met de eerste opdracht vindt u alle versies van de pakketprovider met de naam NuGet. Met de tweede opdracht wordt een opgegeven versie van de NuGet-pakketprovider geïnstalleerd.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Voorbeeld 3: Een provider zoeken en installeren

In dit voorbeeld wordt de pijplijn en gebruikt Find-PackageProvider om te zoeken naar de Gist-provider en deze te installeren.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Voorbeeld 4: Een provider installeren in de modulemap van de huidige gebruiker

Met deze opdracht wordt een pakketprovider geïnstalleerd in $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies , zodat alleen de huidige gebruiker deze kan gebruiken.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parameters

-AllVersions

Geeft aan dat met deze cmdlet alle beschikbare versies van de pakketprovider worden geïnstalleerd. Standaard retourneert Install-PackageProvider alleen de hoogst beschikbare versie.

Type:SwitchParameter
Position:Named
Default value:None
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

Hiermee geeft u een gebruikersaccount op dat is gemachtigd om pakketproviders te installeren.

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

-Force

Geeft aan dat met deze cmdlet alle acties worden afgedwongen met deze cmdlet die kunnen worden geforceerd. Op dit moment betekent dit dat de parameter Force hetzelfde werkt als de parameter ForceBootstrap .

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

-ForceBootstrap

Geeft aan dat met deze cmdlet automatisch de pakketprovider wordt geïnstalleerd.

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

-InputObject

Hiermee geeft u een SoftwareIdentity-object . Gebruik de Find-PackageProvider cmdlet om een SoftwareIdentity-object op te halen dat in wordt doorgesluisd naar Install-PackageProvider.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Hiermee geeft u de maximaal toegestane versie van de pakketprovider die u wilt installeren. Als u deze parameter niet toevoegt, Install-PackageProvider wordt de hoogst beschikbare versie van de provider geïnstalleerd.

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

-MinimumVersion

Hiermee geeft u de minimaal toegestane versie van de pakketprovider die u wilt installeren. Als u deze parameter niet toevoegt, Install-PackageProvider installeert de hoogst beschikbare versie van het pakket die ook voldoet aan alle vereisten die zijn opgegeven door de parameter MaximumVersion .

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

-Name

Hiermee geeft u een of meer modulenamen van de pakketprovider op. Scheid meerdere pakketnamen met komma's. Jokertekens worden niet ondersteund.

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

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag, in plaats van rechtstreeks verbinding te maken met de internetbron.

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

-ProxyCredential

Hiermee geeft u een gebruikersaccount op dat is gemachtigd voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

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

-RequiredVersion

Hiermee geeft u de exacte toegestane versie van de pakketprovider die u wilt installeren. Als u deze parameter niet toevoegt, Install-PackageProvider installeert de hoogst beschikbare versie van de provider die ook voldoet aan een maximumversie die is opgegeven door de Parameter MaximumVersion .

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

-Scope

Hiermee geeft u het installatiebereik van de provider op. De aanvaardbare waarden voor deze parameter zijn:

  • AllUsers : hiermee worden providers geïnstalleerd op een locatie die toegankelijk is voor alle gebruikers van de computer. Dit is standaard $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser : installeert providers op een locatie waar ze alleen toegankelijk zijn voor de huidige gebruiker. Dit is standaard $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Hiermee geeft u een of meer pakketbronnen op. Gebruik de Get-PackageSource cmdlet om een lijst met beschikbare pakketbronnen op te halen.

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

-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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

U kunt een SoftwareIdentity-object doorspeken naar deze cmdlet. Gebruik Find-PackageProvider om een SoftwareIdentity-object op te halen dat kan worden doorgesluisd in Install-PackageProvider.

Notities

Belangrijk

Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Zie de aankondiging in de PowerShell-blog voor meer informatie.