Install-Script

Module:

PowerShellGet

Hiermee installeert u een script.

Syntax

Install-Script
       [-Name] <String[]>
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-RequiredVersion <String>]
       [-Repository <String[]>]
       [-Scope <String>]
       [-NoPathUpdate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-Credential <PSCredential>]
       [-Force]
       [-AllowPrerelease]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Script
       [-InputObject] <PSObject[]>
       [-Scope <String>]
       [-NoPathUpdate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-Credential <PSCredential>]
       [-Force]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

De Install-Script cmdlet verkrijgt een nettolading van een script uit een opslagplaats, controleert of de nettolading een geldig PowerShell-script is en kopieert het scriptbestand naar een opgegeven installatielocatie.

De standaardopslagplaatsen Install-Script kunnen worden geconfigureerd via de Register-PSRepositorycmdlets , Set-PSRepository, Unregister-PSRepositoryen Get-PSRepository . Wanneer u op meerdere opslagplaatsen werkt, Install-Script installeert u zonder fouten het eerste script dat voldoet aan de opgegeven zoekcriteria (Naam, MinimumVersion of MaximumVersion) vanuit de eerste opslagplaats.

Voorbeelden

Voorbeeld 1: Een script zoeken en installeren

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2"
Version    Name                           Type       Repository           Description
-------    ----                           ----       ----------           -----------
2.5        Required-Script2               Script     local1               Description for the Required-Script2 script

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2" | Install-Script
PS C:\> Get-Command -Name "Required-Script2"
CommandType     Name                      Version    Source
-----------     ----                      -------    ------
ExternalScript  Required-Script2.ps1      2.0       C:\Users\pattif\Documents\WindowsPowerShell\Scripts\Required-Script2.ps1

PS C:\> Get-InstalledScript -Name "Required-Script2"
Version    Name                  Type     Repository           Description
-------    ----                  ----     ----------           -----------
2.5        Required-Script2      Script   local1               Description for the Required-Script2 script

PS C:\> Get-InstalledScript -Name "Required-Script2" | Format-List *
Name                       : Required-Script2
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script2 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:39 AM
LicenseUri                 : http://required-script2.com/license
ProjectUri                 : http://required-script2.com/
IconUri                    : http://required-script2.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script2-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script2 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Users\pattif\Documents\WindowsPowerShell\Scripts

Met de eerste opdracht wordt het script met de naam Required-Script2 uit de opslagplaats Local1 gevonden en worden de resultaten weergegeven.

Met de tweede opdracht wordt het Required-Script2 script gevonden en wordt vervolgens de pijplijnoperator gebruikt om het door te geven aan de Install-Script cmdlet om het te installeren.

De derde opdracht gebruikt de Get-Command cmdlet om op te halen Required-Script2en geeft vervolgens de resultaten weer.

De vierde opdracht gebruikt de Get-InstalledScript cmdlet om de resultaten op te halen Required-Script2 en weer te geven.

De vijfde opdracht haalt Required-Script2 de pijplijnoperator op en gebruikt deze om deze door te geven aan de Format-List cmdlet om de uitvoer op te maken.

Voorbeeld 2: Een script installeren met het bereik AllUsers

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script3" -Scope "AllUsers"
PS C:\> Get-InstalledScript -Name "Required-Script3"
Version    Name                  Type       Repository    Description
-------    ----                  ----       ----------    -----------
2.5        Required-Script3      Script     local1        Description for the Required-Script3 script

PS C:\> Get-InstalledScript -Name "Required-Script3" | Format-List *
Name                       : Required-Script3
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script3 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:45 AM
LicenseUri                 : http://required-script3.com/license
ProjectUri                 : http://required-script3.com/
IconUri                    : http://required-script3.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script3-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script3 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Program Files\WindowsPowerShell\Scripts

Met de eerste opdracht wordt het script met de naam Required-Script3 geïnstalleerd en wordt het allUsers-bereik toegewezen.

Met de tweede opdracht wordt het geïnstalleerde script opgehaald en wordt informatie over het script Required-Script3 weergegeven.

Met de derde opdracht wordt de pijplijnoperator doorgegeven Required-Script3 aan de Format-List cmdlet om de uitvoer op te maken.

Voorbeeld 3: Een script en de bijbehorende afhankelijkheden installeren

PS C:\> Find-Script -Repository "Local1" -Name "Script-WithDependencies2" -IncludeDependencies
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Script-WithDependencies2"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script

PS C:\> Get-InstalledModule
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script*"
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script*"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

Met de eerste opdracht wordt het script met de naam Script-WithDependencies2 en de bijbehorende afhankelijkheden in de opslagplaats Local1 gevonden en worden de resultaten weergegeven.

Met de tweede opdracht wordt Script-WithDependencies2geïnstalleerd.

De derde opdracht gebruikt de Get-InstalledScript script-cmdlet om geïnstalleerde scripts op te halen en de resultaten weer te geven.

De vierde opdracht gebruikt de Get-InstalledModule cmdlet om geïnstalleerde modules op te halen en de resultaten weer te geven.

De vijfde opdracht gebruikt de Find-Script cmdlet om scripts te zoeken waarbij de naam begint met Required-Script en de resultaten weer te geven.

Met de zesde opdracht worden de scripts geïnstalleerd waarvan de naam begint in Required-Script de opslagplaats Local1.

Met de laatste opdracht worden geïnstalleerde scripts opgehaald en worden de resultaten weergegeven.

Parameters

-AcceptLicense

Accepteer de gebruiksrechtovereenkomst automatisch tijdens de installatie als de module dit vereist.

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

-AllowPrerelease

Hiermee kunt u een script installeren dat is gemarkeerd als een voorlopige 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 met rechten voor het installeren van een script voor een opgegeven pakketprovider of bron.

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

-Force

Hiermee wordt de opdracht uitgevoerd zonder dat om bevestiging van de gebruiker wordt gevraagd.

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

-InputObject

Wordt gebruikt voor pijplijninvoer. Er treedt een fout op als een waarde rechtstreeks aan InputObject is opgegeven. Gebruik de pijplijn om objecten door te geven met de parameter InputObject .

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

-MaximumVersion

Hiermee geeft u de maximale versie van één script te installeren. U kunt deze parameter niet toevoegen als u meerdere scripts probeert te installeren. De parameters MaximumVersion en RequiredVersion sluiten elkaar uit; u kunt niet beide parameters in dezelfde opdracht gebruiken.

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

-MinimumVersion

Hiermee geeft u de minimale versie van één script te installeren. U kunt deze parameter niet toevoegen als u meerdere scripts probeert te installeren. De parameters MinimumVersion en RequiredVersion sluiten elkaar uit; u kunt niet beide parameters in dezelfde opdracht gebruiken.

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

-Name

Hiermee geeft u een matrix met namen van scripts te installeren.

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

-NoPathUpdate

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

-PassThru

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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:	True
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:	True
Accept wildcard characters:	False

-Repository

Hiermee geeft u de beschrijvende naam van een opslagplaats die is geregistreerd met de Register-PSRepository cmdlet. De standaardwaarde is alle geregistreerde opslagplaatsen.

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

-RequiredVersion

Hiermee geeft u het exacte versienummer van het script te installeren.

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

-Scope

Hiermee geeft u het installatiebereik van het script op. Geldige waarden zijn: AllUsers en CurrentUser.

Met het bereik AllUsers kunnen modules worden geïnstalleerd op een locatie die toegankelijk is voor alle gebruikers van de computer, $env:ProgramFiles\WindowsPowerShell\Scriptsnamelijk .

Met het bereik CurrentUser kunnen modules alleen worden geïnstalleerd voor $HOME\Documents\WindowsPowerShell\Scripts, zodat de module alleen beschikbaar is voor de huidige gebruiker.

Wanneer er geen bereik is gedefinieerd, wordt de standaardwaarde ingesteld op basis van de huidige sessie:

• Voor een PowerShell-sessie met verhoogde bevoegdheden wordt Bereik standaard ingesteld op AllUsers;
• Voor niet-verhoogde PowerShell-sessies in PowerShellGet-versies 2.0.0 en hoger is Het bereik CurrentUser;
• Voor niet-verhoogde PowerShell-sessies in PowerShellGet-versies 1.6.7 en eerder is bereik niet gedefinieerd en Install-Module mislukt het.

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

String[]

PSObject[]

String

Uri

PSCredential

Uitvoerwaarden

Object

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.

Verwante koppelingen

• Find-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script