Install-PSResource

模組:

Microsoft.PowerShell.PSResourceGet

從已註冊的存放庫安裝資源。

語法

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

此 Cmdlet 會將資源從已註冊的存放庫安裝到電腦上的安裝路徑。 根據預設，Cmdlet 不會傳回任何物件。 其他參數可讓您指定資源的存放庫、範圍和版本，以及隱藏授權提示。

此 Cmdlet 會結合 PowerShellGet v2 中 和 Install-Script Cmdlet 的Install-Module函式。

Install-PSResource 不會將新安裝的模組載入目前的工作階段。 您必須匯入新版本，或啟動新的工作階段，才能使用更新的模組。 如需詳細資訊，請參閱 Import-Module。

範例

範例 1

安裝 Az 模組的最新穩定 （非發行前版本） 版本。

Install-PSResource Az

範例 2

在版本7.3.0與 8.3.0之間安裝最新的穩定 Az 模組。

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

範例 3

安裝最新穩定版本的 Az 模組。 使用 Install 參數時，Cmdlet 會寫入任何先前安裝的版本。

Install-PSResource Az -Reinstall

範例 4

安裝 psd1 檔案中指定的 PSResources。

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

範例 5

安裝哈希表中指定的 PSResources。

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

參數

-AcceptLicense

指定資源應接受任何接受許可協定的要求。 如果模組要求使用者接受許可協定，這會抑制提示。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AuthenticodeCheck

驗證 Windows 上的 Authenticode 簽章和目錄檔案。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Credential

存取存放庫時所使用的選擇性認證。

類型:	PSCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

用於管線輸入。

類型:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
別名:	ParentResource
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

要安裝之一或多個資源的名稱。

類型:	String[]
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-NoClobber

防止安裝包含計算機上已存在的 Cmdlet 的套件。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

指定時，輸出 所儲存資源的 PSResourceInfo 物件。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Prerelease

指定時，會在傳回的搜尋結果中包含發行前版本。

類型:	SwitchParameter
別名:	IsPrerelease
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Quiet

隱藏安裝進度列。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Reinstall

即使已安裝最新版本，仍會安裝最新版的模組。 已安裝的版本會遭到覆寫。 這可讓您修復模組的損毀安裝。

如果已安裝較舊的模組版本，則會在新版本特定資料夾中並存安裝新版本。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Repository

指定要搜尋的一或多個存放庫名稱。 如果未指定，搜尋會依優先順序包含所有已註冊的存放庫（最高第一個），直到找到包含封裝的存放庫為止。 存放庫會依優先順序排序，然後依名稱排序。 優先順序較低的值具有較高的優先順序。

在多個存放庫之間搜尋資源時， PSResourceGet Cmdlet 會使用此排序順序來搜尋存放庫。 Install-PSResource 會從儲存機制的排序列表中安裝第一個相符的套件。

參數支援 * 通配符。 如果您指定多個存放庫，則所有名稱都必須包含或省略通配符。 您無法使用 通配符來指定名稱的混合。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	True

-RequiredResource

指定要安裝之資源的哈希表或 JSON 字串。 不允許通配符。 如需檔格式的描述，請參閱 NOTES 一節。

類型:	Object
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-RequiredResourceFile

.psd1或 .json 的路徑，指定要安裝的資源。 不允許通配符。 如需檔格式的描述，請參閱 NOTES 一節。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Scope

指定安裝範圍。 接受的值包括：

• CurrentUser
• AllUsers

默認範圍為 CurrentUser，不需要提高安裝許可權。

AllUsers此範圍會將模組安裝在計算機所有用戶可存取的位置。 例如：

• $env:ProgramFiles\PowerShell\Modules

會將 CurrentUser 模組安裝在只有電腦目前用戶可存取的位置中。 例如：

• $home\Documents\PowerShell\Modules

類型:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
接受的值:	CurrentUser, AllUsers
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SkipDependencyCheck

略過資源相依性的檢查。 只會安裝找到的資源。 未安裝找到資源的資源。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TemporaryPath

指定在實際安裝之前暫時安裝資源的路徑。 如果未提供暫存路徑，資源會暫時安裝在目前使用者的暫存資料夾中。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TrustRepository

隱藏信任存放庫的提示。 只有在存放庫未設定為受信任時，才會發生信任存放庫的提示。

類型:	SwitchParameter
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Version

指定要傳回的資源版本。 此值可以是使用 NuGet 版本設定語法的確切版本或版本範圍。

如需 NuGet 版本範圍的詳細資訊，請參閱 套件版本控制。

PowerShellGet 支援 NuGet 版本範圍檔中所列的最小內含版本。 使用 1.0.0.0 作為版本不會產生 1.0.0.0 版和更新版本（最小內含範圍）。 相反地，此值會被視為必要的版本。 若要搜尋最小內含範圍，請使用 [1.0.0.0, ] 作為版本範圍。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	True

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

輸出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

根據預設，Cmdlet 不會傳回任何物件。 使用PassThru 參數時，Cmdlet 會輸出儲存資源的 PSResourceInfo 物件。

備註

模組會 isres 定義為的 Install-PSResource別名。

RequiredResource 和 RequiredResourceFile 參數可用來尋找符合特定準則的 PSResource 物件。 您可以使用哈希表或 JSON 物件來指定搜尋準則。 針對 RequiredResourceFile 參數，哈希表會儲存在檔案中.psd1，而 JSON 物件會儲存在檔案中.json。 如需詳細資訊，請參閱 about_PSResourceGet。

相關連結

• 套件版本控制
• Uninstall-PSResource