Freigeben über

Add-SCSQLScriptCommand

Modul:
VirtualMachineManager Module

Fügt einer SQL Server-Anwendungsbereitstellung ein SQL Server-Skript hinzu.

Syntax

Default (Standardwert) 

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

Beschreibung

Das Cmdlet Add-SCSQLScriptCommand fügt einer SQL Server-Anwendungsbereitstellung ein Microsoft SQL Server-Skript hinzu.

Beispiele

Beispiel 1: Hinzufügen eines SQL Server-Skripts zu einer Anwendungsbereitstellung

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

Mit dem ersten Befehl wird das Anwendungsprofilobjekt mit dem Namen SvcWebAppProfile01 abgerufen und dann in der Variablen $AppProfile gespeichert.

Der zweite Befehl ruft das Anwendungsbereitstellungsobjekt mit dem Namen SQLDataTierApp01 für das Anwendungsprofil SvcWebAppProfile01 ab und speichert dieses Objekt dann in der Variablen $AppDeployment.

Mit dem dritten Befehl wird das SQL Server-Skriptobjekt mit dem Namen ConfigureDB.sql, Version 1.0, aus der Virtual Machine Manager (VMM)-Bibliothek abgerufen und dann in der Variablen $Script gespeichert.

Mit dem letzten Befehl wird das in $Script gespeicherte SQL Server-Skript der in $AppDeployment gespeicherten Anwendungsbereitstellung hinzugefügt und der Skripttyp, die Bereitstellungsreihenfolge und die Datenbank festgelegt, für die das Skript ausgeführt wird.

Parameter

-ApplicationDeployment

Gibt ein Anwendungsbereitstellungsobjekt an.

Parametereigenschaften

Typ:ApplicationDeployment
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CommandParameters

Gibt die Parameter für ein Skript oder ein ausführbares Programm an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DatabaseName

Gibt den Namen einer Datenbank für ein SQL Server-Skript an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeploymentOrder

Gibt die Reihenfolge an, in der eine Computerebene, ein Anwendungshost oder eine Anwendung bereitgestellt wird.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EncryptConnection

Gibt an, ob die SQL Server-Verbindung verschlüsselt ist.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExecutionTimeoutSeconds

Gibt die Zeitspanne in Sekunden an, die der SQL Server-Skriptbefehl wartet, bevor ein Timeout auftritt.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt verfolgt und gespeichert wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LoginTimeoutSeconds

Gibt an, wie lange eine SQL Server-Anmeldung in Sekunden wartet, bevor ein Timeout auftritt.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OutputFilePath

Gibt einen Dateipfad zum Speichern von Ausgabedaten aus einem SQL Server-Skript an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsAccount

Gibt ein ausführendes Konto an, das Anmeldeinformationen mit der Berechtigung zum Ausführen dieser Aktion enthält.

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SQLAuthenticationType

Gibt den SQL Server-Authentifizierungstyp an. Gültige Werte sind: SQLServerAuthentication und WindowsAuthentication.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SQLScript

Gibt ein SQL Server-Skript an.

Parametereigenschaften

Typ:Script
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SQLScriptType

Gibt einen SQL Server-Skripttyp an. Die zulässigen Werte für diesen Parameter sind:

  • Preinstall
  • Nach der Installation
  • Vor dem Service
  • PostService
  • Vor der Deinstallation
  • Nach der Deinstallation

Parametereigenschaften

Typ:SQLScriptCommandType
Standardwert:None
Zulässige Werte:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WarnAndContinueOnError

Gibt an, ob das Skript den Benutzer warnt und fortfährt, wenn das SQL Server-Skript während der Ausführung auf einen Fehler stößt.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

SQLScriptCommand

Dieses Cmdlet gibt ein SQLScriptCommand-Objekt zurück.