通过

Save-Script

模块:
PowerShellGet Module

保存脚本。

语法

NameAndPathParameterSet （默认值） 

Save-Script
    [-Name] <String[]>
    [-Path] <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameAndLiteralPathParameterSet 

Save-Script
    [-Name] <String[]>
    -LiteralPath <String>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndLiteralPathParameterSet 

Save-Script
    [-InputObject] <PSObject[]>
    -LiteralPath <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectAndPathParameterSet 

Save-Script
    [-InputObject] <PSObject[]>
    [-Path] <String>
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

该 Save-Script cmdlet 保存指定的脚本。

示例

示例 1：保存脚本并验证脚本的元数据

在此示例中，存储库中的脚本将保存到本地计算机，并验证脚本的元数据。

Save-Script -Name Install-VSCode -Repository PSGallery -Path C:\Test\Scripts
Test-ScriptFileInfo -Path C:\Test\Scripts\Install-VSCode.ps1

Version   Name              Author      Description
-------   ----              ------      -----------
1.3       Install-VSCode    Microsoft   This script can be used to easily install Visual Studio Code

Save-Script 使用 Name 参数指定脚本的名称。 存储库参数指定查找脚本的位置。 脚本保存在 Path 参数指定的位置。 Test-ScriptFileInfo 指定 路径 并验证脚本的元数据。

参数

-AcceptLicense

如果脚本需要许可协议，则自动接受许可协议。

参数属性

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

参数集

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

-AllowPrerelease

允许保存标记为预发行版的脚本。

参数属性

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

参数集

NameAndPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

在运行 Save-Script之前，提示你进行确认。

参数属性

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

参数集

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

-Credential

指定有权保存脚本的用户帐户。

参数属性

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

参数集

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

-Force

Save-Script强制运行而不要求用户确认。

参数属性

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

参数集

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

-InputObject

接受 PSRepositoryItemInfo 对象。 例如，输出 Find-Script 变量，并将该变量用作 InputObject 参数。

参数属性

类型:

PSObject[]

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

参数集

InputObjectAndLiteralPathParameterSet
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False
InputObjectAndPathParameterSet
Position:0
必需:True
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-LiteralPath

指定通向一个或多个位置的路径。 LiteralPath 参数的值与输入完全相同。 不会将任何字符解释为通配符。 如果路径包含转义字符，请将路径括在单引号中。 PowerShell 不会将用单引号括起的任何字符解释为转义序列。

参数属性

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

参数集

NameAndLiteralPathParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
InputObjectAndLiteralPathParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-MaximumVersion

指定要保存的脚本的最大值或最新版本。 不能在同一命令中使用 MaximumVersion 和 RequiredVersion 参数。

参数属性

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

参数集

NameAndPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-MinimumVersion

指定要保存的脚本的最低版本。 MinimumVersion 和 RequiredVersion 参数不能在同一命令中使用。

参数属性

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

参数集

NameAndPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Name

指定要保存的脚本名称数组。

参数属性

类型:

String[]

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

参数集

NameAndPathParameterSet
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:0
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Path

指定要存储已保存模块的本地计算机上的位置。 接受通配符。

参数属性

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

参数集

NameAndPathParameterSet
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
InputObjectAndPathParameterSet
Position:1
必需:True
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-Proxy

指定请求的代理服务器，而不是直接连接到 Internet 资源。

参数属性

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

参数集

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

-ProxyCredential

指定有权使用由 Proxy 参数指定的代理服务器的用户帐户。

参数属性

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

参数集

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

-Repository

指定通过运行 Register-PSRepository注册的存储库的友好名称。 使用 Get-PSRepository 显示已注册的存储库。

参数属性

类型:

String[]

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

参数集

NameAndPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-RequiredVersion

指定要保存的脚本的确切版本号。

参数属性

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

参数集

NameAndPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False
NameAndLiteralPathParameterSet
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-WhatIf

显示 Save-Script 运行时会发生什么情况。 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

PSObject

String

Uri

PSCredential

输出

Object

备注

重要

截至 2020 年 4 月，PowerShell 库不再支持传输层安全性（TLS）版本 1.0 和 1.1。 如果未使用 TLS 1.2 或更高版本，则尝试访问 PowerShell 库时会收到错误。 使用以下命令确保使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

有关详细信息，请参阅 PowerShell 博客中的 公告。