Set-SCSQLScriptCommand

修改 SQL Server 脚本的属性。

语法

Default (默认值)

Set-SCSQLScriptCommand
    [-SQLScriptType <SQLScriptCommandType>]
    [-DeploymentOrder <Int32>]
    [-LoginTimeoutSeconds <Int32>]
    [-ExecutionTimeoutSeconds <Int32>]
    [-RunAsAccount <VMMCredential>]
    [-SQLAuthenticationType <String>]
    [-SQLScriptCommand] <SCSQLScriptCommand>
    [-SQLScript <Script>]
    [-CommandParameters <String>]
    [-OutputFilePath <String>]
    [-EncryptConnection <Boolean>]
    [-DatabaseName <String>]
    [-WarnAndContinueOnError <Boolean>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

说明

Set-SCSQLScriptCommand cmdlet 修改与应用程序部署关联的 SQL Server 脚本的属性。

示例

示例 1:修改 SQL Server 脚本命令

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $AppDeployment = Get-SCApplicationDeployment -ApplicationProfile $AppProfile -Name "SQLDataTierApp01"
PS C:\> $SQLScript = Get-SCSQLScriptCommand -ApplicationDeployment $AppDeployment | where {$_.DeploymentOrder -eq "1" -and $_.SQLScriptType -eq "PreInstall"}
PS C:\> Set-SCSQLScriptCommand -SQLScriptCommand $SQLScript -DatabaseName "MSOrders"

第一个命令获取名为 SvcWebAppProfile01 的应用程序配置文件对象,然后将其存储在 $AppProfile 变量中。

第二个命令获取存储在 $ApplicationProfile 中的应用程序配置文件的名为 SQLDataTierApp01 的应用程序部署对象,然后将该对象存储在 $AppDeployment 变量中。

第三个命令获取与存储在 $AppDeployment 中的应用程序部署关联的第一个 PreInstall SQL Server 脚本对象,然后将该对象存储在 $SQLScript 变量中。 cmdlet 通过指定部署顺序 1 和脚本类型 PreInstall 来选择正确的对象。

最后一个命令修改存储$SQLScript SQL Server 脚本将针对其运行的数据库。

参数

-CommandParameters

指定脚本或可执行程序的参数。

参数属性

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

参数集

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

-DatabaseName

指定 SQL Server 脚本的数据库名称。

参数属性

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

参数集

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

-DeploymentOrder

指定计算机层、应用程序主机或应用程序的部署顺序。

参数属性

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

参数集

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

-EncryptConnection

指示 SQL Server 连接是否已加密。

参数属性

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

参数集

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

-ExecutionTimeoutSeconds

指定 SQL Server 脚本命令在超时之前等待的时间(以秒为单位)。

参数属性

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

参数集

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

-JobVariable

指定一个变量,在其中跟踪和存储作业进度。

参数属性

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

参数集

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

-LoginTimeoutSeconds

指定 SQL Server 登录在超时之前等待的时间(以秒为单位)。

参数属性

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

参数集

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

-OutputFilePath

指定用于存储 SQL Server 脚本输出数据的文件路径。

参数属性

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

参数集

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

-PROTipID

指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。

参数属性

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

参数集

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

-RunAsAccount

指定一个运行方式帐户,该帐户包含有权执行此作的凭据。

参数属性

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

参数集

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

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

参数属性

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

参数集

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

-SQLAuthenticationType

指定 SQL Server 身份验证类型。 有效值为:SQLServerAuthentication 和 WindowsAuthentication。

参数属性

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

参数集

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

-SQLScript

指定 SQL Server 脚本。

参数属性

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

参数集

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

-SQLScriptCommand

指定 SQL Server 脚本命令对象。

参数属性

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

参数集

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

-SQLScriptType

指定 SQL Server 脚本类型。 此参数的可接受值为:

  • 预安装
  • 安装后
  • 服务前
  • 邮政服务
  • 预卸载
  • 卸载后

参数属性

类型:SQLScriptCommandType
默认值:None
接受的值:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
支持通配符:False
不显示:False

参数集

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

-WarnAndContinueOnError

指示如果 SQL Server 脚本在运行时遇到错误,脚本是否警告用户并继续。

参数属性

类型:Boolean
默认值:None
支持通配符: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

输出

SQLScriptCommand

此 cmdlet 返回 SQLScriptCommand 对象。