Criar uma etapa de trabalho de um script ActiveX.

Artigo
02/23/2025

Aplica-se a:SQL Server

O subsistema ActiveX é descontinuado a partir do 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

Em de Instância Gerenciada SQL do Azure, a maioria, mas não todos, os recursos do SQL Server Agent são suportados no momento. Consulte Instância Gerenciada 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 anteriores que executa um script ActiveX usando o SQL Server Management Studio, Transact-SQL ou 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 novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso.

Segurança

Para obter informações detalhadas, consulte Implementar o SQL Server Agent Security.

Utilizar o SQL Server Management Studio

Para criar uma etapa de trabalho de Script ActiveX

No Explorador 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 um novo trabalho ou clique com o botão direito num trabalho existente e clique em Propriedades. Para obter mais informações sobre como criar um emprego, consulte Criando empregos.
Na caixa de diálogo Propriedades do Trabalho, clique na página Etapas e, em seguida, clique em Novo.
Na caixa de diálogo Nova Etapa do Trabalho, digite o nome da etapa de trabalho.
Na lista Tipo, clique em ActiveX Script.
Na lista Executar como, selecione a conta proxy com as credenciais que o trabalho usará.
Selecione o idioma no qual o script foi escrito. Como alternativa, clique em Outro e, em seguida, digite o nome da linguagem de script Microsoft ActiveX na qual o script será escrito.
Na caixa de Comando , insira a sintaxe do script que será executada para a etapa de trabalho. Como alternativa, clique em Abrir e selecione um arquivo que contenha a sintaxe do script.
Clique na página Avançado para definir as seguintes opções de etapa de trabalho: qual ação tomar 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 devem ser feitas novas tentativas de tentativa.

Usando Transact-SQL

Para criar uma etapa de trabalho de script ActiveX

No 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 de Script ActiveX

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

Partilhar via