Delen via


Install-Script

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.

Dit is een proxy-cmdlet voor de Install-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Install-PSResource voor meer informatie.

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.

De tweede opdracht zoekt het Required-Script2 script en gebruikt vervolgens de pijplijnoperator 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 maakt gebruik van 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 geïnstalleerd Required-Script3 en toegewezen aan het allusers-bereik.

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

De derde opdracht haalt Required-Script3 de pijplijnoperator op en gebruikt deze 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 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 vinden waarbij de naam begint met 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 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.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Install-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Install-PSResource.

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

-InputObject

Wordt gebruikt voor pijplijninvoer. Er wordt een fout gegenereerd 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

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Install-PSResource.

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

-MinimumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Install-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Install-PSResource.

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

-PassThru

Wanneer u de parameter PassThru gebruikt, Install-Script wordt een PSRepositoryItemInfo-object voor de module uitgevoerd. Dit is dezelfde informatie die u krijgt van de Find-Script cmdlet.

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

-Proxy

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Install-PSResource.

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

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door Install-PSResource.

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

De proxy-cmdlet gebruikt de waarde van deze parameter om een zoekreeks voor een NuGet-versie te maken voor gebruik met de versieparameter van Install-PSResource.

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. 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 op $HOME\Documents\WindowsPowerShell\Scripts, zodat de module alleen beschikbaar is voor de huidige gebruiker.

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

  • Voor een PowerShell-sessie met verhoogde bevoegdheid wordt Bereik standaard ingesteld op AllUsers;
  • Voor PowerShell-sessies zonder verhoogde bevoegdheden in PowerShellGet-versies 2.0.0 en hoger is Het bereik CurrentUser;
  • Voor niet-verhoogde PowerShell-sessies in PowerShellGet versie 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.