Set-SCSQLScriptCommand
SQL Server スクリプトのプロパティを変更します。
構文
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 コマンドレットは、アプリケーションの展開に関連付けられている 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変数に格納します。
2 番目のコマンドは、$ApplicationProfileに格納されているアプリケーション プロファイルの SQLDataTierApp01 という名前のアプリケーション配置オブジェクトを取得し、そのオブジェクトを$AppDeployment変数に格納します。
3 番目のコマンドは、$AppDeploymentに格納されているアプリケーション展開に関連付けられている最初の PreInstall SQL Server スクリプト オブジェクトを取得し、そのオブジェクトを$SQLScript変数に格納します。 コマンドレットは、展開順序 1 と PreInstall のスクリプトの種類を指定して、適切なオブジェクトを選択します。
最後のコマンドは、$SQLScript格納されている SQL Server スクリプトの実行に使用するデータベースを変更します。
パラメーター
-CommandParameters
スクリプトまたは実行可能プログラムのパラメーターを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DatabaseName
SQL Server スクリプトのデータベースの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeploymentOrder
コンピューター層、アプリケーション ホスト、またはアプリケーションを展開する順序を指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EncryptConnection
SQL Server 接続が暗号化されているかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExecutionTimeoutSeconds
SQL Server スクリプト コマンドがタイムアウトするまでに待機する時間を秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡して格納する変数を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LoginTimeoutSeconds
SQL Server ログインがタイムアウトするまでの待機時間を秒単位で指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OutputFilePath
SQL Server スクリプトからの出力データを格納するファイル パスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsAccount
このアクションを実行するアクセス許可を持つ資格情報を含む実行アカウントを指定します。
| 型: | VMMCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SQLAuthenticationType
SQL Server 認証の種類を指定します。 有効な値は、SQLServerAuthentication と WindowsAuthentication です。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SQLScript
SQL Server スクリプトを指定します。
| 型: | Script |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SQLScriptCommand
SQL Server スクリプト コマンド オブジェクトを指定します。
| 型: | SCSQLScriptCommand |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SQLScriptType
SQL Server スクリプトの種類を指定します。 このパラメーターに使用できる値は次のとおりです。
- プレインストール
- PostInstall
- PreService
- PostService
- PreUninstall
- PostUninstall
| 型: | SQLScriptCommandType |
| 指定可能な値: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WarnAndContinueOnError
スクリプトがユーザーに警告し、実行中に SQL Server スクリプトでエラーが発生した場合に続行するかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
SQLScriptCommand
このコマンドレットは、SQLScriptCommand オブジェクトを返します。