共用方式為


Install-PSResource

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

語法

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.08.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