Partager via

Add-SCSQLScriptCommand

  • Référence
Module:
VirtualMachineManager

Ajoute un script SQL Server à un déploiement d’application SQL Server.

Syntaxe

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

Description

L’applet de commande Add-SCSQLScriptCommand ajoute un script Microsoft SQL Server à un déploiement d’application SQL Server.

Exemples

Exemple 1 : Ajouter un script SQL Server à un déploiement d’application

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

La première commande obtient l’objet de profil d’application nommé SvcWebAppProfile01, puis stocke cet objet dans la variable $AppProfile.

La deuxième commande obtient l’objet de déploiement d’application nommé SQLDataTierApp01 pour le profil d’application SvcWebAppProfile01, puis stocke cet objet dans la variable $AppDeployment.

La troisième commande obtient l’objet de script SQL Server nommé ConfigureDB.sql, version 1.0, à partir de la bibliothèque Virtual Machine Manager (VMM), puis stocke cet objet dans la variable $Script.

La dernière commande ajoute le script SQL Server stocké dans $Script au déploiement de l’application stocké dans $AppDeployment et définit le type de script, l’ordre de déploiement et la base de données sur lesquels le script s’exécutera.

Paramètres

-ApplicationDeployment

Spécifie un objet de déploiement d’application.

Type:ApplicationDeployment
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CommandParameters

Spécifie les paramètres d’un script ou d’un programme exécutable.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DatabaseName

Spécifie le nom d’une base de données pour un script SQL Server.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentOrder

Spécifie l’ordre dans lequel une couche ordinateur, un hôte d’application ou une application est déployé.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EncryptConnection

Indique si la connexion SQL Server est chiffrée.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExecutionTimeoutSeconds

Spécifie la durée, en secondes, pendant laquelle la commande de script SQL Server attend avant qu’elle expire.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LoginTimeoutSeconds

Spécifie la durée, en secondes, pendant laquelle une connexion SQL Server attend avant qu’elle expire.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OutputFilePath

Spécifie un chemin d’accès de fichier pour stocker les données de sortie à partir d’un script SQL Server.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsAccount

Spécifie un compte d’identification qui contient des informations d’identification avec l’autorisation d’effectuer cette action.

Type:VMMCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SQLAuthenticationType

Spécifie le type d’authentification SQL Server. Les valeurs valides sont les suivantes : SQLServerAuthentication et WindowsAuthentication.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SQLScript

Spécifie un script SQL Server.

Type:Script
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SQLScriptType

Spécifie un type de script SQL Server. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Préinstaller
  • PostInstall
  • PreService
  • PostService
  • PréInstallation
  • PostUninstall
Type:SQLScriptCommandType
Valeurs acceptées:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WarnAndContinueOnError

Indique si le script avertit l’utilisateur et continue si le script SQL Server rencontre une erreur pendant son exécution.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

SQLScriptCommand

Cette applet de commande retourne un objet SQLScriptCommand.