Add-SCSQLScriptCommand
Agrega un script de SQL Server a una implementación de aplicación de SQL Server.
Sintaxis
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
El cmdlet Add-SCSQLScriptCommand agrega un script de Microsoft SQL Server a una implementación de aplicación de SQL Server.
Ejemplos
Ejemplo 1: Agregar un script de SQL Server a una implementación de aplicación
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
El primer comando obtiene el objeto de perfil de aplicación denominado SvcWebAppProfile01 y, a continuación, almacena ese objeto en la variable $AppProfile.
El segundo comando obtiene el objeto de implementación de la aplicación denominado SQLDataTierApp01 para el perfil de aplicación SvcWebAppProfile01 y, a continuación, almacena ese objeto en la variable $AppDeployment.
El tercer comando obtiene el objeto de script de SQL Server denominado ConfigureDB.sql, versión 1.0, de la biblioteca de Virtual Machine Manager (VMM) y, a continuación, almacena ese objeto en la variable $Script.
El último comando agrega el script de SQL Server almacenado en $Script a la implementación de la aplicación almacenada en $AppDeployment y establece el tipo de script, el orden de implementación y la base de datos en la que se ejecutará el script.
Parámetros
-ApplicationDeployment
Especifica un objeto de implementación de aplicación.
Tipo: | ApplicationDeployment |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-CommandParameters
Especifica los parámetros de un script o un programa ejecutable.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DatabaseName
Especifica el nombre de una base de datos para un script de SQL Server.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DeploymentOrder
Especifica el orden en el que se implementa un nivel de equipo, un host de aplicación o una aplicación.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptConnection
Indica si la conexión de SQL Server está cifrada.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ExecutionTimeoutSeconds
Especifica la cantidad de tiempo, en segundos, que el comando de script de SQL Server espera antes de que se agote el tiempo de espera.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-JobVariable
Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LoginTimeoutSeconds
Especifica la cantidad de tiempo, en segundos, que un inicio de sesión de SQL Server espera antes de que se agote el tiempo de espera.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-OutputFilePath
Especifica una ruta de acceso de archivo para almacenar los datos de salida de un script de SQL Server.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PROTipID
Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
Tipo: | Guid |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RunAsAccount
Especifica una cuenta de ejecución que contiene credenciales con permiso para realizar esta acción.
Tipo: | VMMCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SQLAuthenticationType
Especifica el tipo de autenticación de SQL Server. Los valores válidos son: SQLServerAuthentication y WindowsAuthentication.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SQLScript
Especifica un script de SQL Server.
Tipo: | Script |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SQLScriptType
Especifica un tipo de script de SQL Server. Los valores aceptables para este parámetro son:
- Preinstalar
- PostInstall
- PreService
- PostService
- PreUninstall
- PostUninstall
Tipo: | SQLScriptCommandType |
Valores aceptados: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WarnAndContinueOnError
Indica si el script advierte al usuario y continúa si el script de SQL Server encuentra un error mientras se ejecuta.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Salidas
SQLScriptCommand
Este cmdlet devuelve un objeto SQLScriptCommand.