Executar script do .netRun .Net Script

Importante

Esta versão do Orchestrator atingiu o fim do suporte, recomendamos que você atualize para o orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

A atividade executar script .net executa scripts escritos em VB.NET, JScript, C# e Windows PowerShell.The Run .Net Script activity runs scripts written in VB.NET, JScript, C#, and Windows PowerShell. Essa atividade é compatível com o .NET CLR versão 2,0 e posterior.This activity is compatible with .NET CLR version 2.0 and later. Use a atividade executar script do .net do Microsoft System Center-Orchestrator para executar scripts que analisam dados ou executam funções em APIs disponíveis.Use the Microsoft System Center - Orchestrator Run .Net Script activity to run scripts that parse data or run functions against available APIs.

Configurando a atividade executar script .netConfiguring the Run .Net Script Activity

Antes de configurar a atividade executar script .net, você precisa determinar o seguinte:Before you configure the Run .Net Script activity, you need to determine the following:

  • O código que você deseja executar.The code you want to run.

  • As bibliotecas que você deseja usar.The libraries you want to use.

  • Os dados que você deseja publicar.The data you want to publish.

    Use as informações a seguir para configurar a atividade executar script .net.Use the following information to configure the Run .Net Script activity.

Observação

Não é possível definir credenciais de segurança individuais para esta atividade.You cannot set individual security credentials for this activity. 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á em execução.It will run under the service account configured for the Runbook Service on the Runbook server where the instance of the activity is running. Essa conta deve ter autoridade para acessar os recursos e executar as ações exigidas por essa atividade.This account must have the authority to access the resources and perform the actions required by this activity.

Guia DetalhesDetails Tab

ConfiguraçõesSettings Instruções de configuraçãoConfiguration Instructions
TipoType Selecione a linguagem de script.Select the script language. Use o botão de reticências (...) para procurar o idioma.Use the ellipsis (...) button to browse for the language.
ScriptScript Digite o código que será executado quando a atividade for executada.Type the code that will run when the activity runs.

Guia AvançadoAdvanced Tab

ConfiguraçõesSettings Instruções de configuraçãoConfiguration Instructions
NamespaceNamespace Adicione um namespace para cada namespace do .NET que será usado no seu código.Add a Namespace for each .NET namespace that will be used within your code. Isso permite que você chame o código sem usar nomes totalmente qualificados para cada uma das classes.This allows you to call the code without using fully qualified names for each of the classes. O Orchestrator recomenda adicionar o namespace System a cada execução de atividade de script .net.Orchestrator recommends adding System namespace to every Run .Net Script activity.
ReferênciasReferences Adicione cada uma das referências de assembly (DLL) que contêm as bibliotecas que você deseja usar.Add each of the Assembly (DLL) references that contain the libraries that you want to use. Adicione o System.dll localizado no diretório WINDOWS\Microsoft.NET\Framework \< .NET versão> .Add the System.dll located in the Windows\Microsoft.NET\Framework\<.NET Version> directory.

Dados publicadosPublished Data

Adicione os itens de dados publicados que você deseja que essa atividade publique.Add the published data items that you want this activity to publish. Todos os itens de dados publicados que você adicionar estarão disponíveis no barramento de dados.Every published data item that you add will be available on the Data bus. É importante determinar se um item de dados publicados terá valores múltiplos.It is important to determine if a published data item will be multi-valued. A atividade executar script .net correlaciona automaticamente os dados com valores múltiplos de itens diferentes alinhando-os.The Run .Net Script activity automatically correlates multi-valued data from different items by aligning them. Por exemplo, se você optar por publicar dois itens rotulados como "nome" e "email" como coleções, o script executar .net tentará alinhar cada item na coleção de nomes com cada item na coleção de emails.For example, if you choose to publish two items labeled “Name” and “Email” as Collections, the Run .Net script will try to line up each item in the Name collection with each item in the Email collection. Se as coleções não forem igualmente dimensionadas, a atividade executar script .net criará valores em branco para a coleção que tem menos itens.If the collections are not equally sized, then the Run .Net Script activity will create blank values for the collection that has fewer items. Para obter uma lista de itens de dados e a descrição correspondente publicada por essa atividade, consulte a tabela de dados publicados a seguir.For a list of data items and the corresponding description published by this activity, see the following Published Data table.

Guia dados publicadosPublished Data Tab

ConfiguraçõesSettings Instruções de configuraçãoConfiguration Instructions
NomeName Insira o nome dos dados publicados.Enter the Name of the published data. Esse será o nome que aparece quando outras atividades assinam os dados publicados pela atividade executar script .net.This will be the name that appears when other activities subscribe to the data published by the Run .Net Script activity.
TipoType Você pode selecionar data/hora, inteiroou cadeia de caracteres.You can select Date/Time, Integer, or String. Se o tipo desejado não estiver disponível, selecione cadeia de caracteres.If the type you want is not available, select String. Use o método ToString da atividade para atribuir um valor a esses dados publicados.Use the ToString method of the activity to assign a value to this published data.
ColeçãoCollection Se os dados forem de valores múltiplos, selecione coleção.If your data is multi-valued data, select Collection. Ao usar uma coleção, você deve usar o método Add para adicionar itens à coleção.When using a collection you must use the Add method to add items to the collection. Se você não estiver usando a coleção, poderá usar o operador de atribuição (=) para atribuir o valor.If you are not using the collection you can use the assignment operator (=) to assign the value.
Nome da variávelVariable name Use nomenclatura exclusiva para certificar-se de que o nome da variável não colide com as variáveis existentes em seu script ou com as classes e palavras-chave disponíveis no .NET.Use unique naming to make sure that your variable name does not collide with existing variables within your script or with classes and keywords available in .NET. Recomendamos a prefixação de variáveis com "OPD_".We recommend prefixing variables with “OPD_”. Por exemplo, se você quiser nomear a variável "myString", você deverá nomeá-la como "OPD_myString".For example, if you want to name your variable “myString”, you would name it “OPD_myString”.

A atividade executar script .net criará automaticamente uma propriedade .NET para este item.The Run .Net Script activity will automatically create a .NET Property for this item. Se essa variável for uma coleção, ela será criada usando uma lista <T> , onde T é o tipo que você selecionou.If this variable is a collection it will be created using a List<T>, where T is the Type that you selected. Se não for uma coleção, a propriedade será criada usando uma cadeia de caracteres, um inteiroou uma data/hora com base no tipo que você selecionou.If it is not a collection the property will be created using a String, Integer, or Date/Time based on the Type that you selected.

Dados publicadosPublished Data

ItemItem DescriçãoDescription
Erro padrãoStandard Error Qualquer saída de erro padrão publicada pela atividade executar script .net.Any standard error output published by the Run .Net Script activity.
NamespacesNamespaces Os namespaces usados.The namespaces used.
Saída padrãoStandard Output A saída padrão publicada pela atividade executar script .net.The standard output published by the Run .Net Script activity.
ReferênciasReferences Os assemblies usados na atividade.The Assemblies used in the activity.
Corpo do ScriptScript Body O script que foi executado.The script that was run.
Linguagem de scriptScript Language O idioma que foi selecionado para o script.The language that was selected for the script.

Executar cmdlets do PowerShell de 64 bits com a atividade executar script .NETExecute 64-bit PowerShell cmdlets with Run .NET Script activity

Você pode executar o Windows PowerShell de 64 bits na atividade de script do Orchestrator Run.net .You can run 64-bit Windows PowerShell in Orchestrator Run.Net Script activity. Use as seguintes etapas:Use the following steps:

  1. Crie uma atividade executar script .net do grupo atividades do sistema.Create a Run .Net Script activity from the System activities group.

  2. Em Details > tipode detalhes, selecione PowerShell como o idioma.In Details > Type, select PowerShell as the language.

  3. Em script, coloque os comandos do PowerShell no código a seguir:In Script, enclose your PowerShell commands in the following code:

    Invoke-Command -ScriptBlock {YOUR CODE} -ComputerName localhost
    
    
  4. Clique em Concluir.Click Finish.

    Atividade de script do .net

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 64 e do PowerShell.To verify the PowerShell version, use the following script in Run .Net Script activity and publish the 64 bit and PowerShell version variable.


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

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

Atividade de script do .net