Install-Script

模組:

PowerShellGet v3 Module

安裝腳本。

語法

NameParameterSet (預設值)

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

Cmdlet Install-Script 會從存放庫取得腳本承載、驗證承載是否為有效的 PowerShell 腳本，並將腳本檔案複製到指定的安裝位置。

這是 Install-PSResource 中 Cmdlet 的 Proxy Cmdlet。 如需詳細資訊，請參閱 Install-PSResource。

範例

範例 1：尋找文本並加以安裝

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

第一個命令會從 Local1 存放庫尋找名為 Required-Script2 的腳本，並顯示結果。

第二個命令會 Required-Script2 尋找文本，然後使用管線運算符將它 Install-Script 傳遞給 Cmdlet 以安裝它。

第三個命令會 Get-Command 使用 Cmdlet 來取得 Required-Script2，然後顯示結果。

第四個命令會 Get-InstalledScript 使用 Cmdlet 來取得 Required-Script2 並顯示結果。

第五個命令會取得 Required-Script2 並使用管線運算符將它傳遞至 Format-List Cmdlet 來格式化輸出。

範例 2：使用 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

第一個命令會安裝名為 Required-Script3 的腳本，並指派 AllUsers 範圍。

第二個命令會取得已安裝的腳本 Required-Script3 ，並顯示其相關信息。

第三個命令會取得 Required-Script3 並使用管線運算符將它傳遞至 Format-List Cmdlet 來格式化輸出。

範例 3：安裝腳本及其相依性

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

第一個命令會在 Local1 存放庫中尋找名為 Script-WithDependencies2 的腳本及其相依性，並顯示結果。

第二個命令會 Script-WithDependencies2安裝 。

第三個命令會 Get-InstalledScript 使用腳本 Cmdlet 來取得已安裝的腳本，並顯示結果。

第四個命令會 Get-InstalledModule 使用 Cmdlet 來取得已安裝的模組，並顯示結果。

第五個命令會 Find-Script 使用 Cmdlet 來尋找名稱開頭 Required-Script 為 的腳本，並顯示結果。

第六個命令會安裝名稱開頭為Local1存放庫中的 Required-Script 腳本。

最後一個命令會取得安裝的腳本，並顯示結果。

參數

-AcceptLicense

如果模組需要許可協定，則會自動接受安裝期間的許可協定。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllowPrerelease

可讓您安裝標示為發行前版本的腳本。

Proxy Cmdlet 會將此參數對應至 的Install-PSResource參數。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定有權為指定的套件提供者或來源安裝腳本的用戶帳戶。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Force

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Install-PSResource。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

用於管線輸入。 如果直接提供給 InputObject 的值，就會擲回錯誤。 使用管線傳遞具有 InputObject 參數的物件。

參數屬性

類型:	PSObject[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

InputObject

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-MaximumVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串，以搭配 的 Version 參數 Install-PSResource使用。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-MinimumVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串，以搭配 的 Version 參數 Install-PSResource使用。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Name

指定要安裝的文稿名稱陣列。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NoPathUpdate

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Install-PSResource。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassThru

使用 PassThru 參數時， Install-Script 輸出模組的 PSRepositoryItemInfo 物件。 這是您從 Cmdlet 取得的 Find-Script 相同資訊。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Proxy

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Install-PSResource。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ProxyCredential

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Install-PSResource。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Repository

指定已向 Cmdlet 註冊之 Register-PSRepository 存放庫的易記名稱。 預設值為所有已註冊的存放庫。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RequiredVersion

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串，以搭配 的 Version 參數 Install-PSResource使用。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Scope

指定文稿的安裝範圍。 有效值為：AllUsers 和 CurrentUser。

AllUsers 範圍可讓模組安裝在電腦所有使用者可存取的位置，也就是 $env:ProgramFiles\WindowsPowerShell\Scripts。

CurrentUser 範圍可讓模組只安裝到 $HOME\Documents\WindowsPowerShell\Scripts，讓模組只能供目前使用者使用。

未定義 範圍 時，會根據目前的工作階段來設定預設值：

• 針對提升許可權的 PowerShell 會話， 範圍 預設為 AllUsers;
• 針對 PowerShellGet 2.0.0 版和更新版本中未提升許可權的 PowerShell 會話， 範圍 為 CurrentUser;
• 針對 PowerShellGet 1.6.7 版和更早版本中未提升許可權的 PowerShell 會話， 範圍 未定義且 Install-Module 失敗。

參數屬性

類型:	String
預設值:	None
接受的值:	CurrentUser, AllUsers
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

PSObject

String

Uri

PSCredential

輸出

Object

備註

這很重要

自 2020 年 4 月起，PowerShell 資源庫不再支援傳輸層安全性 （TLS） 1.0 和 1.1 版。 如果您未使用 TLS 1.2 或更高版本，當您嘗試存取 PowerShell 資源庫時，會收到錯誤。 使用下列命令以確保您使用 TLS 1.2：

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

如需詳細資訊，請參閱 PowerShell 部落格中的 公告 。

相關連結

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