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

说明

此 cmdlet 将资源从已注册的存储库安装到计算机上的安装路径。 默认情况下,cmdlet 不返回任何对象。 使用其他参数可以指定资源的存储库、范围和版本,并禁止显示许可证提示。

此 cmdlet 结合了 PowerShellGet v2 中的 cmdlet 和 Install-Script cmdlet 的功能Install-Module

Install-PSResource 不会将新安装的模块加载到当前会话中。 必须导入新版本或启动新会话才能使用更新的模块。 有关详细信息,请参阅 Import-Module

示例

示例 1

安装 Az 模块的最新稳定版本(非预发行版)。

Install-PSResource Az

示例 2

在版本和8.3.0版本7.3.0之间安装最新的稳定 Az 模块。

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

示例 3

安装 Az 模块的最新稳定版本使用“重新安装”参数时,该 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 上的验证码签名和目录文件。

类型: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