Add-SCSQLScriptCommand
將 SQL Server 文本新增至 SQL Server 應用程式部署。
語法
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>]
Description
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 |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-CommandParameters
指定文稿或可執行程序的參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DatabaseName
指定 SQL Server 文稿的資料庫名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DeploymentOrder
指定部署電腦層、應用程式主機或應用程式的順序。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-EncryptConnection
指出 SQL Server 連線是否已加密。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ExecutionTimeoutSeconds
指定 SQL Server 命令在逾時之前等候的時間量,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-JobVariable
指定追蹤和儲存作業進度的變數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-LoginTimeoutSeconds
指定 SQL Server 登入在逾時之前等候的時間量,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-OutputFilePath
指定要從 SQL Server 文稿儲存輸出資料的檔案路徑。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PROTipID
指定觸發此動作之效能和資源優化提示 (PRO 提示) 的識別碼。 此參數可讓您稽核 PRO 秘訣。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RunAsAccount
指定執行身分帳戶,其中包含具有執行此動作許可權的認證。
類型: | VMMCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行,讓控件立即返回命令殼層。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SQLAuthenticationType
指定 SQL Server 驗證類型。 有效值為:SQLServerAuthentication 和 WindowsAuthentication。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SQLScript
指定 SQL Server 文稿。
類型: | Script |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-SQLScriptType
指定 SQL Server 命令稿類型。 此參數可接受的值為:
- 預安裝
- PostInstall
- PreService
- PostService
- PreUninstall
- PostUninstall
類型: | SQLScriptCommandType |
接受的值: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WarnAndContinueOnError
指出文稿是否會警告使用者,並在 SQL Server 腳本執行時遇到錯誤時繼續。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸出
SQLScriptCommand
此 Cmdlet 會傳回 SQLScriptCommand 物件。