共用方式為


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 物件。