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
スクリプトまたは実行可能プログラムのパラメーターを指定します。
| 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: | False |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SQLScriptCommand
SQL Server スクリプト コマンド オブジェクトを指定します。
| Type: | SCSQLScriptCommand |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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: | False |
| 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 オブジェクトを 返します。