Install-PSResource
從已註冊的存放庫安裝資源。
Syntax
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-Module
和 Install-Script
Cmdlet 的功能。
範例
範例 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
指定資源應接受接受授權合約的任何要求。 如果模組要求使用者接受授權合約,這會隱藏提示。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticodeCheck
驗證 Windows 上的 Authenticode 簽章和類別目錄檔案。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
存取存放庫時所使用的選擇性認證。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
用於管線輸入。
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Aliases: | ParentResource |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
要安裝的一或多個資源名稱。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoClobber
防止安裝包含電腦上已存在的 Cmdlet 的套件。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
指定時,會輸出已儲存資源的 PSResourceInfo 物件。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Prerelease
指定時,在傳回的搜尋結果中包含發行前版本。
Type: | SwitchParameter |
Aliases: | IsPrerelease |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Quiet
隱藏安裝進度列。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reinstall
即使已安裝最新版本,仍會安裝最新版本的模組。 已安裝的版本會覆寫。 這可讓您修復模組的損毀安裝。
如果已安裝舊版的模組,新版本會並存安裝在新版本特定資料夾中。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repository
指定要搜尋的一或多個存放庫名稱。 如果未指定,搜尋會以優先順序 (最高的第一個存放庫) ,直到找到包含套件的存放庫為止。 存放庫會依優先順序排序,然後依名稱排序。 優先順序較低的值具有較高的優先順序。
在多個存放庫之間搜尋資源時, PSResourceGet Cmdlet 會使用此排序次序來搜尋存放庫。 Install-PSResource
會從已排序的存放庫清單中安裝第一個相符的套件。
參數支援 *
萬用字元。 如果您指定多個存放庫,所有名稱都必須包含或省略萬用字元。 您無法指定名稱混合與不含萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-RequiredResource
指定要安裝之資源的雜湊表或 JSON 字串。 不允許使用萬用字元。 如需檔案格式的描述,請參閱 NOTES 一節。
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredResourceFile
.psd1
或 .json
的路徑,指定要安裝的資源。 不允許使用萬用字元。 如需檔案格式的描述,請參閱 NOTES 一節。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
指定安裝範圍。 接受的值為:
CurrentUser
AllUsers
預設範圍為 CurrentUser
,不需要提高安裝許可權。
範圍 AllUsers
會將模組安裝在電腦所有使用者可存取的位置。 例如:
$env:ProgramFiles\PowerShell\Modules
會將 CurrentUser
模組安裝在只有電腦目前使用者可存取的位置中。 例如:
$home\Documents\PowerShell\Modules
Type: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipDependencyCheck
略過資源相依性的檢查。 只會安裝找到的資源。 未安裝找到資源的資源。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemporaryPath
指定在實際安裝之前暫時安裝資源的路徑。 如果未提供暫存路徑,資源會暫時安裝在目前使用者的暫存資料夾中。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustRepository
隱藏信任存放庫的提示。 只有在存放庫未設定為受信任時,才會發生信任存放庫的提示。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
指定要傳回的資源版本。 此值可以是使用 NuGet 版本設定語法的確切版本或版本範圍。
如需 NuGet 版本範圍的詳細資訊,請參閱 套件版本控制。
PowerShellGet 支援 NuGet 版本範圍檔中所列的 最小內含版本 。 使用 1.0.0.0
作為版本不會產生 1.0.0.0 版和更新版本, (最小內含範圍) 。 相反地,值會被視為必要的版本。 若要搜尋最小內含範圍,請使用 [1.0.0.0, ]
作為版本範圍。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 不會執行此 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
String[]
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。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應