Install-Script

Module:

PowerShellGet Module

Hiermee wordt een script geïnstalleerd.

Syntax

NameParameterSet (Standaard)

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

InputObject

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 zijn configureerbaar via de Register-PSRepository, Set-PSRepositoryen Unregister-PSRepositoryGet-PSRepository cmdlets. Wanneer u werkt met meerdere opslagplaatsen, Install-Script installeert u het eerste script dat overeenkomt met de opgegeven zoekcriteria (Name, MinimumVersion of MaximumVersion) uit de eerste opslagplaats zonder fouten.

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 uit Required-Script2 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 en weer te geven Required-Script2 .

Met de vijfde opdracht wordt Required-Script2 de pijplijnoperator gebruikt 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 het bereik AllUsers 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 Required-Script3 de pijplijnoperator gebruikt om deze door te geven 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 maakt gebruik van de Get-InstalledScript script-cmdlet om geïnstalleerde scripts op te halen en de resultaten weer te geven.

De vierde opdracht maakt gebruik van 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 vinden waarin de naam begint Required-Script en de resultaten weer te geven.

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

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

Parameters

-AcceptLicense

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

Parametereigenschappen

Type:	SwitchParameter
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

-AllowPrerelease

Hiermee kunt u een script installeren dat is gemarkeerd als een voorlopige versie.

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

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

Hiermee geeft u een gebruikersaccount met rechten voor het installeren van een script voor een opgegeven pakketprovider of bron.

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:	True
Waarde van resterende argumenten:	False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Parametereigenschappen

Type:	SwitchParameter
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. Er wordt een fout gegenereerd als er een waarde rechtstreeks aan InputObject wordt opgegeven. Gebruik de pijplijn om objecten door te geven met de parameter InputObject .

Parametereigenschappen

Type:	PSObject[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

InputObject

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

-MaximumVersion

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

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-MinimumVersion

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

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-Name

Hiermee geeft u een matrix van namen van scripts die moeten worden geïnstalleerd.

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-NoPathUpdate

Standaard voegt deze opdracht de installatielocatie van het script toe aan de $env:PATH omgevingsvariabele. Wanneer u de schakeloptie NoPathUpdate gebruikt, wordt de $env:PATH variabele niet bijgewerkt met de opdracht.

Parametereigenschappen

Type:	SwitchParameter
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

-PassThru

Wanneer u de parameter PassThru gebruikt, Install-Script wordt een PSRepositoryItemInfo-object voor het script uitgevoerd.

Parametereigenschappen

Type:	SwitchParameter
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

-Proxy

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

Parametereigenschappen

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

Parametersets

(All)

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

-ProxyCredential

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

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:	True
Waarde van resterende argumenten:	False

-Repository

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

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-RequiredVersion

Hiermee geeft u het exacte versienummer van het script dat moet worden geïnstalleerd.

Parametereigenschappen

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

Parametersets

NameParameterSet

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

-Scope

Hiermee geeft u het installatiebereik van het script. 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, dat wil $env:ProgramFiles\WindowsPowerShell\Scriptsgezegd.

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

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

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

Parametereigenschappen

Type:	String
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

-WhatIf

Toont wat er zou gebeuren wanneer 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

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