Set-SCSQLScriptCommand

Module:

VirtualMachineManager Module

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

Syntaxe

Default (Par défaut)

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’applet de commande Set-SCSQLScriptCommand 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 récupère l’objet de profil d’application nommé SvcWebAppProfile01, puis le stocke dans la variable $AppProfile.

La deuxième commande récupère 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 récupère le premier objet de script SQL Server de préinstallation associé au déploiement de l’application stocké dans $AppDeployment, puis stocke l’objet dans la variable $SQLScript. L’applet de commande sélectionne l’objet correct en spécifiant un ordre de déploiement de 1 et un type de script PreInstall.

La dernière commande modifie la base de données sur 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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DatabaseName

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DeploymentOrder

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

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-EncryptConnection

Indique si la connexion SQL Server est chiffrée.

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ExecutionTimeoutSeconds

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

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-JobVariable

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-LoginTimeoutSeconds

Spécifie la durée, en secondes, pendant laquelle une connexion SQL Server attend avant d’expirer.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-OutputFilePath

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Guid
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RunAsAccount

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

Propriétés du paramètre

Type:	VMMCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-SQLAuthenticationType

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-SQLScript

Spécifie un script SQL Server.

Propriétés du paramètre

Type:	Script
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-SQLScriptCommand

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

Propriétés du paramètre

Type:	SCSQLScriptCommand
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-SQLScriptType

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

• Préinstaller
• Post-installation
• Avant le service
• Service postal
• Pré-désinstallation
• PostDésinstaller

Propriétés du paramètre

Type:	SQLScriptCommandType
Valeur par défaut:	None
Valeurs acceptées:	PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WarnAndContinueOnError

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

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

SQLScriptCommand

Cette applet de commande retourne un objet SQLScriptCommand .

Liens associés

• Add-SCSQLScriptCommand
• Get-SCApplicationDeployment
• Get-SCApplicationProfile
• Get-SCSQLScriptCommand
• Remove-SCSQLScriptCommand