Add-SCSQLScriptCommand
将 SQL Server 脚本添加到 SQL Server 应用程序部署中。
语法
Default (默认值)
Add-SCSQLScriptCommand
[-LoginTimeoutSeconds <Int32>]
[-ExecutionTimeoutSeconds <Int32>]
[-RunAsAccount <VMMCredential>]
-ApplicationDeployment <ApplicationDeployment>
-SQLScriptType <SQLScriptCommandType>
-SQLScript <Script>
-DeploymentOrder <Int32>
[-CommandParameters <String>]
[-OutputFilePath <String>]
[-EncryptConnection <Boolean>]
[-DatabaseName <String>]
[-SQLAuthenticationType <String>]
[-WarnAndContinueOnError <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
说明
Add-SCSQLScriptCommand cmdlet 将 Microsoft SQL Server 脚本添加到 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-SCScript -Name "ConfigDB.sql" -Release "1.0"
PS C:\> Add-SCSQLScriptCommand -ApplicationDeployment $AppDeployment -SQLScriptType "PreInstall" -DeploymentOrder 1 -DatabaseName "MSSQLSERVER" -SQLScript $SQLScript
第一个命令获取名为 SvcWebAppProfile01 的应用程序配置文件对象,然后将该对象存储在 $AppProfile 变量中。
第二个命令获取 SvcWebAppProfile01 应用程序配置文件的名为 SQLDataTierApp01 的应用程序部署对象,然后将该对象存储在 $AppDeployment 变量中。
第三个命令从 Virtual Machine Manager (VMM) 库中获取名为 ConfigureDB.sql 版本 1.0 的 SQL Server 脚本对象,然后将该对象存储在 $Script 变量中。
最后一个命令将存储在 $Script 中的 SQL Server 脚本添加到存储在 $AppDeployment 中的应用程序部署中,并设置脚本类型、部署顺序和脚本将针对其运行的数据库。
参数
-ApplicationDeployment
指定应用程序部署对象。
参数属性
| 类型: | ApplicationDeployment
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-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 |
| 必需: | True |
| 来自管道的值: | 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 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SQLScriptType
指定 SQL Server 脚本类型。
此参数的可接受值为:
参数属性
| 类型: | SQLScriptCommandType
|
| 默认值: | None |
| 接受的值: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | 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 对象。