Executar script .NET

A atividade Executar Script do .NET executa scripts escritos em VB.NET, JScript, C# e Windows PowerShell. Essa atividade é compatível com o .NET CLR versão 2.0 e posterior. Use a atividade Microsoft System Center – Orchestrator Run .NET Script para executar scripts que analisam dados ou executam funções em APIs disponíveis.

Configurar a atividade Executar Script .NET

Antes de configurar a atividade Executar Script do .NET, você precisa determinar o seguinte:

• O código que você deseja executar.

• As bibliotecas que você deseja usar.

• Os dados que você deseja publicar.

  Use as informações a seguir para configurar a atividade Executar Script do .NET.

Observação

Não é possível definir credenciais de segurança individuais para essa atividade. Ele será executado na conta de serviço configurada para o Serviço Runbook no servidor Runbook em que a instância da atividade está sendo executada. Essa conta deve ter autoridade para acessar os recursos e executar as ações exigidas por essa atividade.

Guia Detalhes

Configurações	Instruções de configuração
Tipo	Selecione o idioma do script. Use o botão de reticências (...) para procurar o idioma.
Script	Insira o código que será executado quando a atividade for executada.

Guia Avançado

Configurações	Instruções de configuração
Namespace	Adicione um Namespace para cada namespace .NET que será usado em seu código. Isso permite que você chame o código sem usar nomes totalmente qualificados para cada uma das classes. O Orchestrator recomenda adicionar o namespace System a cada atividade Executar Script .NET.
Referências	Adicione cada uma das referências de assembly (DLL) que contêm as bibliotecas que você deseja usar. Adicione o System.dll localizado no diretório Windows\Microsoft.NET\Framework\<.NET Version>.

Dados publicados

Adicione os itens de dados publicados que você deseja que essa atividade publique. Cada item de dados publicado que você adicionar estará disponível no barramento de dados. É importante determinar se um item de dados publicado terá vários valores. A atividade Executar Script do .NET correlaciona automaticamente dados de vários valores de diferentes itens, alinhando-os. Por exemplo, se você optar por publicar dois itens rotulados Nome e Email como Coleções, o script Executar .NET tentará alinhar cada item na coleção Name com cada item na coleção Email. Se as coleções não forem igualmente dimensionadas, a atividade Executar Script do .NET criará valores em branco para a coleção que tem menos itens. A tabela de Dados Publicados a seguir lista os itens de dados e a descrição correspondente publicada por essa atividade.

Guia Dados Publicados

Configurações	Instruções de configuração
Nome	Insira o Nome dos dados publicados. Esse será o nome que aparecerá quando outras atividades assinarem os dados publicados pela atividade Executar Script do .NET.
Tipo	Você pode selecionar Data/Hora, Inteiro ou String. Se o tipo desejado não estiver disponível, selecione Cadeia de caracteres. Use o método ToString da atividade para atribuir um valor a esses dados publicados.
Coleção	Se os dados forem dados de vários valores, selecione Coleção. Ao usar uma coleção, você deve usar o método Add para adicionar itens à coleção. Se você não estiver usando a coleção, poderá usar o operador de atribuição (=) para atribuir o valor.
Nome da variável	Use a nomenclatura exclusiva para garantir que o nome da variável não colida com variáveis existentes em seu script ou com classes e palavras-chave disponíveis no .NET. Recomendamos prefixar variáveis com OPD_. Por exemplo, se você quiser nomear sua variável myString, você a nomearia OPD_myString. A atividade Executar Script do .NET criará automaticamente uma propriedade do .NET para esse item. Se essa variável for uma coleção, ela será criada usando uma Lista<T>, em que T é o Tipo que você selecionou. No entanto, se não for uma coleção, a propriedade será criada usando uma String, Integer ou Date/Time com base no Type selecionado.

Dados publicados

Item	Descrição
Erro Padrão	Qualquer saída de erro padrão publicada pela atividade Executar Script do .NET.
Namespaces	Os namespaces usados.
Saída Padrão	A saída padrão publicada pela atividade Executar Script do .NET.
Referências	Os assemblies usados na atividade.
Corpo do script	O script que foi executado.
Linguagem de script	O idioma selecionado para o script.

Executar cmdlets do PowerShell de 64 bits com a atividade Executar Script do .NET

Você pode executar o Windows PowerShell de 64 bits na atividade Orchestrator Run.Net Script . Use as seguintes etapas:

1. Crie uma atividade Executar Script do .NET no grupo de atividades do sistema.

2. Em Tipo de Detalhes>, selecione PowerShell como o idioma.

3. Em Script, coloque seus comandos do PowerShell no seguinte código:

   Invoke-Command -ScriptBlock {YOUR CODE} -ComputerName localhost
   
   

4. Selecione Concluir.

   

Observação

Para verificar a versão do PowerShell, use o script a seguir na atividade Executar Script do .NET e publique a variável de versão de 64 bits e do PowerShell.

$Result = Invoke-Command -ComputerName localhost {
$Is64BitProcess = [Environment]::Is64BitProcess
$PSVersion = $PSVersionTable.PSVersion
RETURN $Is64BitProcess, $PSVersion
}

$64bit = $Result[0]
$PSVersion = $Result[1]