Add-SCSQLScriptCommand
Adiciona um script SQL Server a uma implantação de aplicativo SQL Server.
Syntax
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 SQL Server.
Exemplos
Exemplo 1: adicionar um script 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 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 SQL Server armazenado em $Script à implantação do 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.
Type: | ApplicationDeployment |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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: | True |
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: | True |
Accept pipeline input: | False |
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: | True |
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 .