Compartilhar via


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 .