Install-Script

  • Referens
Modul:
PowerShellGet

Installerar ett skript.

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

Cmdleten Install-Script hämtar en skriptnyttolast från en lagringsplats, verifierar att nyttolasten är ett giltigt PowerShell-skript och kopierar skriptfilen till en angiven installationsplats.

Standardlagringsplatserna som Install-Script fungerar mot kan konfigureras via cmdletarna Register-PSRepository, Set-PSRepository, Unregister-PSRepositoryoch Get-PSRepository. När du arbetar mot flera lagringsplatser installerar Install-Script det första skriptet som matchar de angivna sökvillkoren (Name, MinimumVersioneller MaximumVersion) från den första lagringsplatsen utan något fel.

Exempel

Exempel 1: Hitta ett skript och installera det

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

Det första kommandot hittar skriptet med namnet Required-Script2 från Local1-lagringsplatsen och visar resultatet.

Det andra kommandot hittar Required-Script2-skriptet och använder sedan pipelineoperatorn för att skicka det till cmdleten Install-Script för att installera det.

Det tredje kommandot använder cmdleten Get-Command för att hämta Required-Script2och visar sedan resultatet.

Det fjärde kommandot använder cmdleten Get-InstalledScript för att hämta Required-Script2 och visa resultatet.

Det femte kommandot hämtar Required-Script2 och använder pipelineoperatorn för att skicka den till cmdleten Format-List för att formatera utdata.

Exempel 2: Installera ett skript med AllUsers-omfång

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

Det första kommandot installerar skriptet med namnet Required-Script3 och tilldelar det AllUsers-omfång.

Det andra kommandot hämtar det installerade skriptet Required-Script3 och visar information om det.

Det tredje kommandot hämtar Required-Script3 och använder pipelineoperatorn för att skicka den till cmdleten Format-List för att formatera utdata.

Exempel 3: Installera ett skript och dess beroenden

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

Det första kommandot hittar skriptet med namnet Script-WithDependencies2 och dess beroenden på local1-lagringsplatsen och visar resultatet.

Det andra kommandot installerar Script-WithDependencies2.

Det tredje kommandot använder cmdleten Get-InstalledScript skript för att hämta installerade skript och visa resultatet.

Det fjärde kommandot använder cmdleten Get-InstalledModule för att hämta installerade moduler och visa resultatet.

Det femte kommandot använder cmdleten Find-Script för att hitta skript där namnet börjar med Required-Script och visa resultatet.

Det sjätte kommandot installerar skripten där namnet börjar med Required-Script på local1-lagringsplatsen.

Det sista kommandot hämtar installerade skript och visar resultatet.

Parametrar

-AcceptLicense

Godkänn licensavtalet automatiskt under installationen om modulen kräver det.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AllowPrerelease

Gör att du kan installera ett skript som har markerats som en förhandsversion.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett användarkonto som har behörighet att installera ett skript för en angiven paketleverantör eller källa.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Används för pipelineindata. Ett fel utlöses om ett värde som anges direkt till InputObject. Använd pipelinen för att skicka objekt med parametern InputObject.

Typ:PSObject[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MaximumVersion

Anger den maximala versionen av ett enskilt skript som ska installeras. Du kan inte lägga till den här parametern om du försöker installera flera skript. Parametrarna MaximumVersion och parametrarna RequiredVersion utesluter varandra. du kan inte använda båda parametrarna i samma kommando.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-MinimumVersion

Anger den lägsta versionen av ett enskilt skript som ska installeras. Du kan inte lägga till den här parametern om du försöker installera flera skript. Parametrarna MinimumVersion och parametrarna RequiredVersion är ömsesidigt uteslutande. du kan inte använda båda parametrarna i samma kommando.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger en matris med namn på skript som ska installeras.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoPathUpdate

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av parametern Proxy.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Repository

Anger det egna namnet på en lagringsplats som har registrerats med cmdleten Register-PSRepository. Standardvärdet är alla registrerade lagringsplatser.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RequiredVersion

Anger det exakta versionsnumret för skriptet som ska installeras.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Scope

Anger installationsomfånget för skriptet. Giltiga värden är: AllUsers och CurrentUser.

Omfånget AllUsers låter moduler installeras på en plats som är tillgänglig för alla användare av datorn, det vill $env:ProgramFiles\WindowsPowerShell\Scripts.

Med CurrentUser-omfånget kan moduler endast installeras för att $home\Documents\WindowsPowerShell\Scripts, så att modulen endast är tillgänglig för den aktuella användaren.

När ingen Omfång har definierats anges standardinställningen baserat på den aktuella sessionen:

  • För en upphöjd PowerShell-session Omfång standardvärdet Allaanvändare.
  • För icke-upphöjda PowerShell-sessioner i PowerShellGet-version 2.0.0 och senare är Scope CurrentUser.
  • För icke-upphöjda PowerShell-sessioner i PowerShellGet-versionerna 1.6.7 och tidigare är Omfång odefinierat och Install-Module misslyckas.
Typ:String
Godkända värden:CurrentUser, AllUsers
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String[]

PSObject[]

String

Uri

PSCredential

Utdata

Object

Kommentarer

Viktig

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:

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

Mer information finns i meddelande i PowerShell-bloggen.