Set-SCSQLScriptCommand
Modifica las propiedades de un script de SQL Server.
Sintaxis
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
El cmdlet Set-SCSQLScriptCommand modifica las propiedades de un script de SQL Server asociado a una implementación de aplicación.
Ejemplos
Ejemplo 1: Modificación de un comando de script de 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"El primer comando obtiene el objeto de perfil de aplicación denominado SvcWebAppProfile01 y, a continuación, lo almacena 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 almacenado en $ApplicationProfile y, a continuación, almacena ese objeto en la variable $AppDeployment.
El tercer comando obtiene el primer objeto de script de SQL Server preinstalado asociado a la implementación de la aplicación almacenada en $AppDeployment y, a continuación, almacena el objeto en la variable $SQLScript. El cmdlet selecciona el objeto correcto especificando un orden de implementación de 1 y un tipo de script de PreInstall.
El último comando modifica la base de datos con la que se ejecutará el script de SQL Server almacenado $SQLScript.
Parámetros
-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: | False |
| 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: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SQLScriptCommand
Especifica un objeto de comando de script de SQL Server.
| Tipo: | SCSQLScriptCommand |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| 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: | False |
| 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.