Partilhar via

Set-SCSQLScriptCommand

Módulo:
VirtualMachineManager Module

Modifica as propriedades de um script do SQL Server.

Sintaxe

Default (Predefinição) 

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 do SQL Server associado a uma implantação de aplicativo.

Exemplos

Exemplo 1: Modificar um comando de script do 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, em seguida, armazena-o na variável $AppProfile.

O segundo comando obtém o objeto de implantação de aplicativo chamado SQLDataTierApp01 para o perfil de aplicativo armazenado no $ApplicationProfile e, em seguida, 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 no $AppDeployment e, em seguida, armazena o objeto na variável $SQLScript. O cmdlet seleciona o objeto correto especificando uma ordem de implantação de 1 e um tipo de script de PreInstall.

O último comando modifica o banco de dados no qual o script do SQL Server armazenado $SQLScript será executado.

Parâmetros

-CommandParameters

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DatabaseName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DeploymentOrder

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EncryptConnection

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ExecutionTimeoutSeconds

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-LoginTimeoutSeconds

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OutputFilePath

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsAccount

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

Propriedades dos parâmetros

Tipo:VMMCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SQLAuthenticationType

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SQLScript

Especifica um script do SQL Server.

Propriedades dos parâmetros

Tipo:Script
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SQLScriptCommand

Especifica um objeto de comando de script do SQL Server.

Propriedades dos parâmetros

Tipo:SCSQLScriptCommand
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SQLScriptType

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

  • Pré-instalação
  • Pós-instalação
  • Pré-serviço
  • Serviço Postal
  • Pré-desinstalar
  • PostDesinstalar

Propriedades dos parâmetros

Tipo:SQLScriptCommandType
Default value:None
Valores aceites:PreInstall, PostInstall, PreService, PostService, PreUninstall, PostUninstall
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WarnAndContinueOnError

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

SQLScriptCommand

Este cmdlet retorna um objeto SQLScriptCommand .