Set-SCSQLScriptCommand
Modifica as propriedades de um script de SQL Server.
Syntax
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
O cmdlet Set-SCSQLScriptCommand modifica as propriedades de um script de SQL Server associado a uma implantação de aplicativo.
Exemplos
Exemplo 1: modificar um comando 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"
O primeiro comando obtém o objeto de perfil de aplicativo chamado SvcWebAppProfile01 e o armazena na variável $AppProfile.
O segundo comando obtém o objeto de implantação de aplicativo chamado SQLDataTierApp01 para o perfil de aplicativo armazenado em $ApplicationProfile e armazena esse objeto na variável $AppDeployment.
O terceiro comando obtém o primeiro objeto de script PreInstall SQL Server associado à implantação do aplicativo armazenado em $AppDeployment e armazena o objeto na variável $SQLScript. O cmdlet seleciona o objeto correto especificando uma ordem de implantação 1 e um tipo de script de PreInstall.
O último comando modifica o banco de dados no qual o script SQL Server armazenado $SQLScript será executado.
Parâmetros
-CommandParameters
Especifica os parâmetros para um script ou programa executável.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatabaseName
Especifica o nome de um banco de dados para um script de SQL Server.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOrder
Especifica a ordem na qual uma camada de computador, host de aplicativo ou aplicativo é implantado.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptConnection
Indica se a conexão SQL Server está criptografada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExecutionTimeoutSeconds
Especifica a quantidade de tempo, em segundos, que o comando de script SQL Server aguarda antes de atingir o tempo limite.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica uma variável na qual o progresso do trabalho é rastreado e armazenado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LoginTimeoutSeconds
Especifica a quantidade de tempo, em segundos, que um logon SQL Server aguarda antes de atingir o tempo limite.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputFilePath
Especifica um caminho de arquivo para armazenar dados de saída de um script de SQL Server.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsAccount
Especifica uma conta Executar como que contém credenciais com permissão para executar essa ação.
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SQLAuthenticationType
Especifica o tipo de autenticação SQL Server. Os valores válidos são: SQLServerAuthentication e WindowsAuthentication.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SQLScript
Especifica um script de SQL Server.
Type: | Script |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SQLScriptCommand
Especifica um objeto de comando de script SQL Server.
Type: | SCSQLScriptCommand |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SQLScriptType
Especifica um tipo de script SQL Server. Os valores aceitáveis para esse parâmetro são:
- Pré-instalar
- PostInstall
- PreService
- PostService
- Pré-instalação
- PostUninstall
Type: | SQLScriptCommandType |
Accepted values: | PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WarnAndContinueOnError
Indica se o script avisa o usuário e continua se o script SQL Server encontra um erro durante a execução.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
SQLScriptCommand
Este cmdlet retorna um objeto SQLScriptCommand .