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>] 説明
Add-SCSQLScriptCommand コマンドレットは、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 変数に格納します。
2 番目のコマンドは、SvcWebAppProfile01 アプリケーション プロファイルの SQLDataTierApp01 という名前のアプリケーション配置オブジェクトを取得し、そのオブジェクトを $AppDeployment 変数に格納します。
3 番目のコマンドは、ConfigureDB.sql リリース 1.0 という名前のSQL Server スクリプト オブジェクトを Virtual Machine Manager (VMM) ライブラリから取得し、そのオブジェクトを $Script 変数に格納します。
最後のコマンドは、$Scriptに格納されているSQL Server スクリプトを$AppDeploymentに格納されているアプリケーション展開に追加し、スクリプトの種類、配置順序、およびスクリプトを実行するデータベースを設定します。
パラメーター
-ApplicationDeployment
アプリケーション展開オブジェクトを指定します。
| Type: | ApplicationDeployment |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CommandParameters
スクリプトまたは実行可能プログラムのパラメーターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DatabaseName
SQL Server スクリプトのデータベースの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentOrder
コンピューター層、アプリケーション ホスト、またはアプリケーションを展開する順序を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EncryptConnection
SQL Server接続が暗号化されているかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExecutionTimeoutSeconds
SQL Server スクリプト コマンドがタイムアウトするまでに待機する時間を秒単位で指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して格納する変数を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LoginTimeoutSeconds
SQL Server ログインがタイムアウトするまでの待機時間を秒単位で指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputFilePath
SQL Server スクリプトからの出力データを格納するファイル パスを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAccount
このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。
| Type: | VMMCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SQLAuthenticationType
SQL Server認証の種類を指定します。 有効な値は、SQLServerAuthentication と WindowsAuthentication です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SQLScript
SQL Server スクリプトを指定します。
| Type: | Script |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SQLScriptType
SQL Serverスクリプトの種類を指定します。 このパラメーターの有効値は、次のとおりです。
- プレインストール
- PostInstall
- PreService
- PostService
- PreUninstall
- PostUninstall
| Type: | SQLScriptCommandType |
| Accepted values: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WarnAndContinueOnError
スクリプトがユーザーに警告し、SQL Server スクリプトの実行中にエラーが発生した場合に続行するかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
出力
SQLScriptCommand
このコマンドレットは 、SQLScriptCommand オブジェクトを 返します。