Criar uma etapa de trabalho de script ActiveX

Artigo
02/22/2025

aplica-se a: do SQL Server

O subsistema ActiveX é descontinuado a partir do SQL Server 2016. Converter 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

Na Instância Gerenciada de SQL do Azure , a maioria, mas não todos os recursos do SQL Server Agent são suportados atualmente. Consulte Instância Gerenciada de SQL do Azure do SQL Server para obter detalhes.

Este tópico descreve como criar e definir uma etapa de trabalho do Microsoft SQL Server Agent no SQL Server 2014 e anterior que executa um script ActiveX usando o SQL Server Management Studio, o Transact-SQL ou os Objetos de Gerenciamento do SQL Server.

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 um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso.

Segurança

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

Usar o SQL Server Management Studio

Para criar uma etapa de trabalho do ActiveX Script

No Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de Dados do SQL Server e, em seguida, expanda essa instância.
Expanda SQL Server Agent, crie uma nova tarefa ou clique com o botão direito do mouse em uma tarefa existente e depois clique em Propriedades. Para obter mais informações sobre como criar um trabalho, consulte Criando trabalhos.
Na caixa de diálogo Propriedades do Trabalho, clique na página Etapas e clique em Novo.
Na caixa de diálogo Nova Etapa de Trabalho, digite um nome de Etapa de Trabalho.
Na lista tipo , clique em Script ActiveX.
Na lista Executar como, selecione a conta proxy com as credenciais que a tarefa usará.
Selecione o idioma no qual o script foi escrito. Como alternativa, clique em Outras e, em seguida, insira o nome da linguagem de script do Microsoft ActiveX na qual o script será escrito.
Na caixa de comando , insira a sintaxe de script que será executada para o passo de trabalho. Como alternativa, clique em Abrir e selecione um arquivo que contém a sintaxe de script.
Clique na página Avançado para definir as seguintes opções de etapa de trabalho: que ação executar se a etapa de trabalho for bem-sucedida ou falhar, quantas vezes o SQL Server Agent deve tentar executar a etapa de trabalho e com que frequência as tentativas de repetição devem ser feitas.

Usando Transact-SQL

Para criar uma etapa de tarefa de script ActiveX

Em Pesquisador de Objetos, conecte-se a uma instância do Mecanismo de Banco de Dados.
Na barra Padrão, clique em Nova Consulta.

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 objetos de gerenciamento do SQL Server

Para criar uma etapa de trabalho do Script ActiveX

Use a classe JobStep usando uma linguagem de programação escolhida, como Visual Basic, Visual C#ou PowerShell.

Compartilhar via