Udostępnij przez


Add-SCSQLScriptCommand

Dodaje skrypt programu SQL Server do wdrożenia aplikacji programu SQL Server.

Składnia

Default (Domyślna)

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 dodaje skrypt programu Microsoft SQL Server do wdrożenia aplikacji programu SQL Server.

Przykłady

Przykład 1: Dodawanie skryptu 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 zapisuje ten obiekt w zmiennej $AppProfile.

Drugie polecenie pobiera obiekt wdrożenia aplikacji o nazwie SQLDataTierApp01 dla profilu aplikacji SvcWebAppProfile01, a następnie zapisuje ten obiekt w zmiennej $AppDeployment.

Trzecie polecenie pobiera obiekt skryptu programu SQL Server o nazwie ConfigureDB.sql w wersji 1.0 z biblioteki programu Virtual Machine Manager (VMM), a następnie zapisuje ten obiekt w zmiennej $Script.

Ostatnie polecenie dodaje skrypt programu SQL Server przechowywany w programie $Script do wdrożenia aplikacji przechowywanego w $AppDeployment i ustawia typ skryptu, kolejność wdrażania i bazę danych, względem której skrypt będzie uruchamiany.

Parametry

-ApplicationDeployment

Określa obiekt wdrożenia aplikacji.

Właściwości parametru

Typ:ApplicationDeployment
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CommandParameters

Określa parametry skryptu lub programu wykonywalnego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DatabaseName

Określa nazwę bazy danych dla skryptu programu SQL Server.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DeploymentOrder

Określa kolejność, w jakiej jest wdrażana warstwa komputera, host aplikacji lub aplikacja.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EncryptConnection

Wskazuje, czy połączenie z programem SQL Server jest szyfrowane.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ExecutionTimeoutSeconds

Określa czas (w sekundach), przez który polecenie skryptu programu SQL Server czeka przed upływem limitu czasu.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobVariable

Określa zmienną, w której jest śledzony i przechowywany postęp zadania.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-LoginTimeoutSeconds

Określa czas (w sekundach), przez który logowanie do programu SQL Server czeka przed upływem limitu czasu.

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OutputFilePath

Określa ścieżkę pliku do przechowywania danych wyjściowych ze skryptu programu SQL Server.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsAccount

Określa konto Uruchom jako, które zawiera poświadczenia z uprawnieniami do wykonania tej akcji.

Właściwości parametru

Typ:VMMCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SQLAuthenticationType

Określa typ uwierzytelniania programu SQL Server. Prawidłowe wartości to: SQLServerAuthentication i WindowsAuthentication.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SQLScript

Określa skrypt programu SQL Server.

Właściwości parametru

Typ:Script
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SQLScriptType

Określa typ skryptu programu SQL Server. Dopuszczalne wartości tego parametru to:

  • Preinstalacji
  • Po instalacji
  • Serwis wstępny
  • Poczta
  • Wstępna dezinstalacja
  • Po odinstalowaniu

Właściwości parametru

Typ:SQLScriptCommandType
Domyślna wartość:None
Dopuszczalne wartości:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WarnAndContinueOnError

Wskazuje, czy skrypt ostrzega użytkownika i kontynuuje działanie, jeśli skrypt SQL Server napotka błąd podczas uruchamiania.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

SQLScriptCommand

To polecenie cmdlet zwraca obiekt SQLScriptCommand .