Install-PSResource

参考

模块:: Microsoft.PowerShell.PSResourceGet

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

语法

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

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

语法

说明

示例

示例 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

语法

说明

示例

示例 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

输入

输出

备注

相关链接

反馈

其他资源