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 中的 和 Install-Script
cmdlet 的功能Install-Module
。
示例
示例 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 模块的最新稳定版本。 使用 重新安装 参数时,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 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈