Add-SCSQLScriptCommand

  • Referenz
Modul:
VirtualMachineManager

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

Syntax

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 Add-SCSQLScriptCommand-Cmdlet fügt einem 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

Der erste Befehl ruft das Anwendungsprofilobjekt mit dem Namen SvcWebAppProfile01 ab und speichert dieses Objekt dann in der $AppProfile Variablen.

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

Der dritte Befehl ruft das SQL Server Skriptobjekt namens ConfigureDB.sql, Release 1.0, aus der VMM-Bibliothek (Virtual Machine Manager) ab und speichert dieses Objekt dann in der $Script Variablen.

Der letzte Befehl fügt das in $Script gespeicherte skript SQL Server zur in $AppDeployment gespeicherten Anwendungsbereitstellung hinzu und legt den Skripttyp, die Bereitstellungsreihenfolge und die Datenbank fest, für die das Skript ausgeführt wird.

Parameter

-ApplicationDeployment

Gibt ein Anwendungsbereitstellungsobjekt an.

Type:ApplicationDeployment
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CommandParameters

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentOrder

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-EncryptConnection

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExecutionTimeoutSeconds

Gibt die Zeit in Sekunden an, die der Befehl für das skript SQL Server wartet, bevor es ausläuft.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LoginTimeoutSeconds

Gibt die Zeitspanne in Sekunden an, die eine SQL Server Anmeldung wartet, bevor sie ausgedauert wird.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputFilePath

Gibt einen Dateipfad an, der Ausgabedaten aus einem SQL Server Skript speichert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

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

Type:VMMCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SQLAuthenticationType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SQLScript

Gibt ein SQL Server Skript an.

Type:Script
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SQLScriptType

Gibt einen SQL Server Skripttyp an. Zulässige Werte für diesen Parameter:

  • Preinstall
  • PostInstall
  • PreService
  • PostService
  • PreUninstall
  • PostUninstall
Type:SQLScriptCommandType
Accepted values:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WarnAndContinueOnError

Gibt an, ob das Skript den Benutzer warnt und fortgesetzt wird, wenn das SQL Server-Skript während der Ausführung einen Fehler auftritt.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

SQLScriptCommand

Dieses Cmdlet gibt ein SQLScriptCommand-Objekt zurück.