Partager via

Set-SCSQLScriptCommand

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’un script SQL Server.

Syntaxe

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

Description

L'Set-SCSQLScriptCommand cmdlet modifie les propriétés d’un script SQL Server associé à un déploiement d’application.

Exemples

Exemple 1 : Modifier une commande de script 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"

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

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

La troisième commande obtient le premier objet de script SQL Server PreInstall associé au déploiement d’application stocké dans $AppDeployment, puis stocke l’objet dans la variable $SQLScript. L’applet de commande sélectionne l’objet approprié en spécifiant un ordre de déploiement de 1 et un type de script de PréInstall.

La dernière commande modifie la base de données par rapport à laquelle le script SQL Server stocké $SQLScript s’exécutera.

Paramètres

-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:False
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:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SQLScriptCommand

Spécifie un objet de commande de script SQL Server.

Type:SCSQLScriptCommand
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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:False
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.