Add-SCSQLScriptCommand
Dodaje skrypt programu SQL Server do wdrożenia aplikacji programu SQL Server.
Składnia
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>]
Opis
Polecenie cmdlet add-SCSQLScriptCommand
Przykłady
Przykład 1. Dodawanie skryptu programu SQL Server do wdrożenia aplikacji
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
Pierwsze polecenie pobiera obiekt profilu aplikacji o nazwie SvcWebAppProfile01, a następnie przechowuje ten obiekt w zmiennej $AppProfile.
Drugie polecenie pobiera obiekt wdrożenia aplikacji o nazwie SQLDataTierApp01 dla profilu aplikacji SvcWebAppProfile01, a następnie przechowuje ten obiekt w zmiennej $AppDeployment.
Trzecie polecenie pobiera obiekt skryptu programu SQL Server o nazwie ConfigureDB.sql, wydanie 1.0, z biblioteki programu Virtual Machine Manager (VMM), a następnie przechowuje ten obiekt w zmiennej $Script.
Ostatnie polecenie dodaje skrypt programu SQL Server przechowywany w $Script do wdrożenia aplikacji przechowywanego w $AppDeployment i ustawia typ skryptu, kolejność wdrażania i bazę danych, na której zostanie uruchomiony skrypt.
Parametry
-ApplicationDeployment
Określa obiekt wdrożenia aplikacji.
Typ: | ApplicationDeployment |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-CommandParameters
Określa parametry skryptu lub programu wykonywalnego.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DatabaseName
Określa nazwę bazy danych dla skryptu programu SQL Server.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DeploymentOrder
Określa kolejność wdrażania warstwy komputera, hosta aplikacji lub aplikacji.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-EncryptConnection
Wskazuje, czy połączenie z programem SQL Server jest szyfrowane.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ExecutionTimeoutSeconds
Określa czas w sekundach oczekiwania polecenia skryptu programu SQL Server przed upływem limitu czasu.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa zmienną, w której postęp zadania jest śledzony i przechowywany.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-LoginTimeoutSeconds
Określa czas oczekiwania logowania programu SQL Server w sekundach przed upływem limitu czasu.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-OutputFilePath
Określa ścieżkę pliku do przechowywania danych wyjściowych ze skryptu programu SQL Server.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PROTipID
Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.
Typ: | Guid |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RunAsAccount
Określa konto Uruchom jako zawierające poświadczenia z uprawnieniem do wykonania tej akcji.
Typ: | VMMCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SQLAuthenticationType
Określa typ uwierzytelniania programu SQL Server. Prawidłowe wartości to: SQLServerAuthentication i WindowsAuthentication.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SQLScript
Określa skrypt programu SQL Server.
Typ: | Script |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SQLScriptType
Określa typ skryptu programu SQL Server. Dopuszczalne wartości tego parametru to:
- Preinstalacji
- PostInstall
- PreService
- PostService
- PreUninstall
- PostUninstall
Typ: | SQLScriptCommandType |
Dopuszczalne wartości: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WarnAndContinueOnError
Wskazuje, czy skrypt ostrzega użytkownika i kontynuuje działanie, jeśli skrypt programu SQL Server napotka błąd podczas jego działania.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
SQLScriptCommand
To polecenie cmdlet zwraca obiekt SQLScriptCommand.