Criar uma etapa de trabalho de script ActiveX

  • Artigo

Aplica-se a:SQL Server

O subsistema ActiveX está descontinuado desde o SQL Server 2016. Converta todas as etapas de trabalho existentes que usam o script ActiveX em uma Etapa de trabalho de script do PowerShell. Use o PowerShell para qualquer desenvolvimento futuro.

Importante

Atualmente, na Instância Gerenciada de SQL do Azure, a maioria dos recursos do SQL Server Agent é compatível, mas não todos. Confira Instância Gerenciada de SQL do Azure no SQL Server para obter mais detalhes.

Esse tópico descreve como criar e definir uma etapa de trabalho do Microsoft SQL Server Agent no SQL Server 2014 e versões anteriores que executa um script do ActiveX usando o SQL Server Management Studio, o Transact-SQL ou o SQL Server Management Objects.

Antes de começar

Limitações e Restrições

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

Segurança

Para obter informações detalhadas, consulte Implementar a segurança do SQL Server Agent.

Use SQL Server Management Studio.

Para criar uma etapa de trabalho de Script ActiveX

  1. No Pesquisador de Objetos , conecte-se a uma instância do Mecanismo de Banco de Dados do SQL Servere a expanda.

  2. Expanda SQL Server Agent, crie um novo trabalho ou clique com o botão direito do mouse em um trabalho existente e clique em Propriedades. Para obter mais informações sobre como criar um trabalho, consulte Criando trabalhos.

  3. Na caixa de diálogo Propriedades do Trabalho , clique na página Etapas e, em seguida, em Nova.

  4. Na caixa de diálogo Nova Etapa de Trabalho , digite o Nome da etapade trabalho.

  5. Na lista Tipo , clique em Script ActiveX.

  6. Na lista Executar como , selecione a conta proxy com as credenciais que o trabalho usará.

  7. Selecione o Idioma no qual o script foi escrito. Como alternativa, clique em Outro e insira o nome da linguagem de script do ActiveX da Microsoft em que o script foi escrito.

  8. Na caixa Comando , insira a sintaxe de script que será executada para a etapa de trabalho. Como alternativa, clique em Abrir e selecione um arquivo que contenha a sintaxe de script.

  9. Clique na página Avançado para definir as seguintes opções de etapa de trabalho: a ação a tomar em caso de êxito ou falha da etapa, quantas vezes o SQL Server Agent deve tentar executar a etapa e com que frequência.

Usando o Transact-SQL

Para criar uma etapa de trabalho de script do ActiveX

  1. No Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de Dados.

  2. Na barra Padrão, clique em Nova Consulta.

  3. Copie e cole o exemplo a seguir na janela de consulta e clique em Executar.

    -- create an ActiveX Script job step written in VBScript that creates a restore point  
USE msdb;  
GO  
EXEC sp_add_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_name = N'Create a restore point',  
    @subsystem = N'ACTIVESCRIPTING',  
    @command = N'Const RESTORE_POINT = 20  

strComputer = "."  
Set objWMIService = GetObject("winmgmts:" _  
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\default")  

Set objItem = objWMIService.Get("SystemRestore")  
errResults = objItem.Restore(RESTORE_POINT)',   
    @retry_attempts = 5,  
    @retry_interval = 5 ;  
GO

Para obter mais informações, consulte sp_add_jobstep (Transact-SQL).

Usando o SQL Server Management Objects

Para criar uma etapa de trabalho de Script ActiveX

Use a classe JobStep com uma linguagem de programação à sua escolha, como Visual Basic, Visual C# ou PowerShell.