Compartilhar via

Add-SCSQLScriptCommand

  • Referência
Módulo:
VirtualMachineManager

Adiciona um script do SQL Server a uma implantação de aplicativo do SQL Server.

Sintaxe

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

O cmdlet Add-SCSQLScriptCommand adiciona um script do Microsoft SQL Server a uma implantação de aplicativo do SQL Server.

Exemplos

Exemplo 1: adicionar um script do SQL Server a uma implantação de aplicativo

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

O primeiro comando obtém o objeto de perfil de aplicativo chamado SvcWebAppProfile01 e armazena esse objeto na variável $AppProfile.

O segundo comando obtém o objeto de implantação de aplicativo chamado SQLDataTierApp01 para o perfil de aplicativo SvcWebAppProfile01 e armazena esse objeto na variável $AppDeployment.

O terceiro comando obtém o objeto de script do SQL Server chamado ConfigureDB.sql, versão 1.0, da biblioteca do VMM (Virtual Machine Manager) e armazena esse objeto na variável $Script.

O último comando adiciona o script do SQL Server armazenado em $Script à implantação de aplicativo armazenada em $AppDeployment e define o tipo de script, a ordem de implantação e o banco de dados no qual o script será executado.

Parâmetros

-ApplicationDeployment

Especifica um objeto de implantação de aplicativo.

Tipo:ApplicationDeployment
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CommandParameters

Especifica os parâmetros para um script ou programa executável.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseName

Especifica o nome de um banco de dados para um script do SQL Server.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentOrder

Especifica a ordem na qual uma camada de computador, host de aplicativo ou aplicativo é implantado.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptConnection

Indica se a conexão do SQL Server está criptografada.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExecutionTimeoutSeconds

Especifica a quantidade de tempo, em segundos, que o comando de script do SQL Server aguarda antes de atingir o tempo limite.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LoginTimeoutSeconds

Especifica a quantidade de tempo, em segundos, que um logon do SQL Server aguarda antes de atingir o tempo limite.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OutputFilePath

Especifica um caminho de arquivo para armazenar dados de saída de um script do SQL Server.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsAccount

Especifica uma conta Executar como que contém credenciais com permissão para executar essa ação.

Tipo:VMMCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SQLAuthenticationType

Especifica o tipo de autenticação do SQL Server. Os valores válidos são: SQLServerAuthentication e WindowsAuthentication.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SQLScript

Especifica um script do SQL Server.

Tipo:Script
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SQLScriptType

Especifica um tipo de script do SQL Server. Os valores aceitáveis para este parâmetro são:

  • Pré-instalar
  • PostInstall
  • PreService
  • PostService
  • Pré-instalação
  • PostUninstall
Tipo:SQLScriptCommandType
Valores aceitos:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WarnAndContinueOnError

Indica se o script avisa o usuário e continua se o script do SQL Server encontra um erro durante a execução.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

SQLScriptCommand

Esse cmdlet retorna um objeto SQLScriptCommand.