Install-PSResource

參考

模組:: Microsoft.PowerShell.PSResourceGet

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

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[]

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。

Install-PSResource

Syntax

Description

範例

範例 1

範例 2

範例 3

範例 4

範例 5

參數

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

輸入

輸出

備註

意見反應

其他資源

Install-PSResource

Syntax

Description

範例

範例 1

範例 2

範例 3

範例 4

範例 5

參數

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

輸入

輸出

備註

相關連結

意見反應

其他資源