Install-PSResource

从已注册的存储库安装资源。

语法

NameParameterSet (默认值)

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

InputObjectParameterSet

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

RequiredResourceFileParameterSet

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

RequiredResourceParameterSet

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

说明

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

此 cmdlet 结合了 Install-Module v2 中 Install-Script cmdlet 的函数。

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

注释

Install-PSResource 不会从使用 NuGet v3 协议的存储库安装依赖资源。 必须单独安装依赖资源。 我们打算在将来的版本中添加此功能。

示例

示例 1

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

Install-PSResource Az -Repository PSGallery

Az 模块是一个元模块,其中包含所有 Az PowerShell 模块作为依赖项。 此命令安装 Az 模块及其所有依赖项。

示例 2

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

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
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AuthenticodeCheck

验证 Windows 上的验证码签名和目录文件。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Credential

访问存储库时使用的可选凭据。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

用于管道输入。

参数属性

类型:

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

默认值:None
支持通配符:False
不显示:False
别名:父资源

参数集

InputObjectParameterSet
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

要安装的一个或多个资源的名称。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

NameParameterSet
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NoClobber

阻止安装包含计算机上已存在的 cmdlet 的包。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PassThru

指定后,输出已保存资源的 PSResourceInfo 对象。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Prerelease

指定后,在返回的搜索结果中包含预发行版版本。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:是发行前

参数集

NameParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Quiet

禁止安装进度栏。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Reinstall

安装最新版本的模块,即使已安装最新版本。 将覆盖已安装的版本。 这样就可以修复模块的损坏安装。

如果安装了较旧版本的模块,则会在特定于新版本的文件夹中并行安装新版本。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Repository

指定要搜索的一个或多个存储库名称。 如果未指定,搜索将按优先级顺序(最高第一个)包括所有已注册的存储库,直到找到包含包的存储库。 存储库按优先级排序,然后按名称排序。 较低 优先级 值具有更高的优先级。

跨多个存储库搜索资源时,PSResourceGet cmdlet 使用此排序顺序搜索存储库。 Install-PSResource 从存储库的排序列表中安装第一个匹配包。

该参数支持 * 通配符。 如果指定多个存储库,则所有名称都必须包含或省略通配符。 不能使用通配符和不使用通配符指定名称的组合。

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

NameParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
InputObjectParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-RequiredResource

指定要安装的资源的哈希表或 JSON 字符串。 不允许使用通配符。 有关文件格式的说明,请参阅 NOTES 部分。

参数属性

类型:Object
默认值:None
支持通配符:False
不显示:False

参数集

RequiredResourceParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RequiredResourceFile

指定要安装的资源的 .psd1.json 的路径。 不允许使用通配符。 有关文件格式的说明,请参阅 NOTES 部分。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

RequiredResourceFileParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Scope

指定安装范围。 接受的值包括:

  • CurrentUser
  • AllUsers

默认作用域为 CurrentUser,不需要提升进行安装。

AllUsers 范围将模块安装在计算机所有用户可访问的位置。 例如:

  • $env:ProgramFiles\PowerShell\Modules

CurrentUser 将模块安装在仅可供计算机的当前用户访问的位置。 例如:

  • $home\Documents\PowerShell\Modules

参数属性

类型:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
默认值:None
接受的值:CurrentUser, AllUsers
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkipDependencyCheck

跳过资源依赖项的检查。 仅安装找到的资源。 未安装找到的资源。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TemporaryPath

指定在实际安装之前临时安装资源的路径。 如果未提供临时路径,资源将临时安装在当前用户的临时文件夹中。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TrustRepository

禁止提示信任存储库。 仅当存储库未配置为受信任时,才会出现信任存储库提示。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Version

指定要返回的资源的版本。 该值可以是使用 NuGet 版本控制语法的确切版本或版本范围。

有关 NuGet 版本范围的详细信息,请参阅 包版本控制

PowerShellGet 支持 NuGet 版本范围文档中列出的所有 最低非独占版本。 使用 1.0.0.0,因为版本不会生成版本 1.0.0.0 及更高版本(最低非独占范围)。 相反,该值被视为所需的版本。 若要搜索最小非独占范围,请使用 [1.0.0.0, ] 作为版本范围。

参数属性

类型:String
默认值:None
支持通配符:True
不显示:False

参数集

NameParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

输出

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

默认情况下,cmdlet 不返回任何对象。 使用 PassThru 参数时,该 cmdlet 会输出已保存资源的 PSResourceInfo 对象。

备注

该模块将 isres 定义为 Install-PSResource的别名。

RequiredResourceRequiredResourceFile 参数用于查找与特定条件匹配 PSResource 对象。 可以使用哈希表或 JSON 对象指定搜索条件。 对于 RequiredResourceFile 参数,哈希表存储在 .psd1 文件中,JSON 对象存储在 .json 文件中。 有关详细信息,请参阅 about_PSResourceGet