Udostępnij przez


Set-SCSQLScriptCommand

Modyfikuje właściwości skryptu programu SQL Server.

Składnia

Default (Domyślna)

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>]

Opis

Polecenie cmdlet Set-SCSQLScriptCommand modyfikuje właściwości skryptu programu SQL Server skojarzonego z wdrożeniem aplikacji.

Przykłady

Przykład 1: Modyfikowanie polecenia skryptu programu 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"

Pierwsze polecenie pobiera obiekt profilu aplikacji o nazwie SvcWebAppProfile01, a następnie zapisuje go w zmiennej $AppProfile.

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

Trzecie polecenie pobiera pierwszy obiekt skryptu PreInstall SQL Server skojarzony z wdrożeniem aplikacji przechowywanym w $AppDeployment, a następnie zapisuje obiekt w zmiennej $SQLScript. Polecenie cmdlet wybiera poprawny obiekt, określając kolejność wdrożenia 1 i typ skryptu PreInstall.

Ostatnie polecenie modyfikuje bazę danych, względem której zostanie uruchomiony skrypt przechowywany w $SQLScript SQL Server.

Parametry

-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:False
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:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SQLScriptCommand

Określa obiekt polecenia skryptu programu SQL Server.

Właściwości parametru

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

Zestawy parametrów

(All)
Position:0
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

-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:False
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 .