---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Criação de uma atividade PowerShell

# Criação de uma atividade PowerShell {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Crie uma atividade PowerShell personalizada para retornar dados a um fluxo de trabalho a partir de um host usando o Microsoft PowerShell.

## Antes de Iniciar

Funções necessárias: activity_creator ou workflow_admin

## Por Que e Quando Desempenhar Esta Tarefa

ServiceNow é compatível com o PowerShell 3.0 ao 5.1.

## Procedimento

1. Crie uma [atividade personalizada](https://www.servicenow.com/docs/access?context=create-custom-activities&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).  
   Esta ação cria uma atividade personalizada usando um modelo.
2. Depois de configurar [as propriedades gerais](https://servicenow-prod.fluidtopics.net/1UjFRbbKboyY5Zc2E4CIWg "Os seguintes campos de propriedade geral são comuns a todos os modelos de designer de atividades.") e [criar variáveis de entrada](https://servicenow-prod.fluidtopics.net/Vmd4tof2SU2d891ouFr3mA#CreateInputVariables "Crie as variáveis a serem passadas para a atividade no formulário de Entradas do designer de atividades."), configure o Comando de Execução PowerShell.

   | Opção | Descrição |
   | [Mapear as variáveis de entrada](https://servicenow-prod.fluidtopics.net/Vmd4tof2SU2d891ouFr3mA#t_MapAnInputVariable "Depois de criar as variáveis de entrada, mapeie-as para os campos no formulário de Comando de Execução.") | Use as variáveis que você criou para configurar o comando que a Orquestração executa no MID Server. |
   | Host de destino | Nome do host ou endereço IP do servidor de destino para esta atividade do PowerShell. |
   | Tipo de script | Tipo de script do PowerShell a ser executado no host do PowerShell. Opções disponíveis incluem: * Comando PowerShell personalizado * Arquivo de script do MID Server {#t_CreateAPowershellActivity__ul_bsj_mzp_vz} |
   | Arquivo de script do MID Server | O arquivo de script do MID Server contém os scripts do PowerShell. Este campo está disponível quando o tipo de script selecionado é o arquivo de script do MID Server. |
   | Comando | Comando do PowerShell que a atividade executa. Este campo está disponível quando o tipo de script selecionado é o comando PowerShell personalizado. Você pode criar seus comandos arrastando e soltando variáveis de entrada do construtor de variáveis para este campo. |
   | Variáveis do PowerShell | Pares de nome-valor a serem passados para o host com o PowerShell. Você pode criar essas variáveis manualmente ou arrastar variáveis de entrada para o campo Valor. As variáveis de entrada criptografadas mantêm sua criptografia, independentemente das configurações de tipo de dados neste campo. Se você digitar um valor e selecionar o tipo de dado Criptografado, o valor aparecerá em texto sem formatação. Ele só é criptografado quando passa para a Fila do ECC. |
   | Usar conta de serviço do MID | Se marcada, esta atividade autentica no host de destino usando somente as credenciais da conta de serviço do MID Server, sem tentar nenhuma outra credencial. Nota: O campo de marcador de credencial não está disponível. |
   | Marcador de credencial | Marcador de credencial que esta atividade deve usar para executar comandos do PowerShell no host. Se este campo for deixado em branco, o MID Server tentará todas as credenciais disponíveis até encontrar uma credencial válida, terminando com a conta de serviço do MID Server. Se um marcador de credencial for definido, o MID Server tentará as credenciais somente para esse marcador e não tentará a conta de serviço do MID Server. Nota: Este campo não está disponível quando a caixa de seleção Usar conta de serviço do MID está marcada. |
   | Requer recursos do MID Server | MID Server a ser usado pelos recursos para consultar o PowerShell. Por padrão, o sistema seleciona um PowerShell MID Server. |
   |-|-|

   {#t_CreateAPowershellActivity__choicetable_asj_mzp_vz}  
   Nota:  
   Você pode mapear valores de parâmetro em uma carga de teste para variáveis na guia Saídas automaticamente. Consulte [variáveis de saída do mapeamento automático](https://servicenow-prod.fluidtopics.net/pOj5hFNcSh91pTEAZFUlbw "Você pode mapear valores de parâmetro em uma carga de teste para variáveis na guia Saídas automaticamente.").

## O que Fazer Depois

Conclua a criação da sua atividade PowerShell [criando variáveis de saída](https://servicenow-prod.fluidtopics.net/sXKmOLhX4OS_OSSbELtjlw#t_CreateAnOutputVariable "O formulário de Saídas no designer contém um construtor de variável para criar estruturas de dados de objetos e matrizes."), [criando uma regra de análise](https://servicenow-prod.fluidtopics.net/OHRZm7~d7NBO7ww7dBD0DQ#t_CreateAParsingRule "Preencha as variáveis de saída definidas em uma atividade personalizada com dados de carga retornados de um teste de entradas em um host externo ou endpoint.") ou [Condições](https://www.servicenow.com/docs/access?context=conditions&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Consulte o tópico [criar atividades personalizadas](https://servicenow-prod.fluidtopics.net/N1ouR9Z1M~iHSGZICueGpQ "Você pode criar e atualizar diferentes tipos de atividades personalizadas no Editor de Fluxo de Trabalho usando um modelo personalizado.") para conhecer as opções de modelo.

## Parâmetros de execução do modelo PowerShell {#ariaid-title2}

Você usa parâmetros de execução para criar o script do processo de entrada no formulário de pré-processamento do designer de atividades.
Para obter descrições dos campos de comando do PowerShell, consulte a tabela em [Configuração do comando de execução do PowerShell](https://servicenow-prod.fluidtopics.net/Vmd4tof2SU2d891ouFr3mA#t_MapPowershellVariablesToExecCmd "Use as variáveis de entrada que você criou para configurar o comando que a Orquestração executa na máquina de destino do Windows.").  
Nota:  
É necessário usar o prefixo `executionParam.` com todas as variáveis nesta tabela. {#r_PshellTmpltExctnPrm__table_b2b_jw5_cr__entry__4}

| Nome | Variável | Tipo | Uso |
|-|-|-|-|
| Origem | origem | Cadeia de caracteres | Host de destino no qual o comando será executado. |
| Tipo de script | script_type | Enumeração | Tipo de script a ser executado. Os tipos possíveis são: * command: comando PowerShell personalizado. * file: identifica o arquivo de script do MID Server a ser executado. {#r_PshellTmpltExctnPrm__ul_fz2_nw5_cr} |
| Comando | comando | Cadeia de caracteres | Comando enviado ao MID Server para ser executado no host de destino. |
| MidScriptFile | midScriptFile | Referência | Sys_id de referência do arquivo de script do MID Server a ser executado, quando o script_type for file. |
| PowershellVariables | powershellVariables | Matriz de hashmap | Hashmap de objetos JavaScript com nome, valore tipo de cada objeto. O tipo de cada objeto pode ser simples, criptografado, boolianoou nulo, correspondendo ao tipo de variável do PowerShell selecionada na guia de entradas. Por exemplo, você pode inserir: var newParameter = {"name":"parameterName","value":"parameterValue", "type": "plain" }; executionParam.powershellVariables.push(newParameter); |
| Marcador de credencial | credential_tag | Cadeia de caracteres | Marcador de credencial específico que esta atividade deve usar para executar comandos do PowerShell no host. |
| MidCapabilities | midCapabilities | Cadeia de caracteres (separados por vírgulas) | Lista de recursos MID Server exigidos. |
| ValueCapabilities | valueCapabilities | Matriz de hashmap | Valores de recursos usados para selecionar o MID Server. Para obter mais informações, consulte [Recursos do MID Server](https://servicenow-prod.fluidtopics.net/rg38bYgvEJwXabeJWDvNSg "Os recursos do MID Server definem as funções específicas de um MID Server dentro de um intervalo de endereços IP."). Se houver recursos adicionais atribuídos por valor, use este exemplo para personalizar a seleção do MID Server: var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); |
[Tabela 1. Parâmetros de execução do PowerShell]

{#r_PshellTmpltExctnPrm__table_b2b_jw5_cr}

## Análise de carga e parâmetros de pós-processamento do PowerShell {#ariaid-title3}

Use esses parâmetros para criar um script de pós-processamento, análide se carga e marcação.
{#powershell-payload-parsing-tags__table_grr_t2v_cr__entry__4}

| Nome | Variável | Tipo | Uso |
|-|-|-|-|
| Marcadores | marcadores | Hashmap de valores de marcador a serem retornados do comando do PowerShell. | Contém os marcadores usados para extrair a saída usando os comandos do PowerShell. A saída do marcador é delimitada por sinais de porcentagem dupla, como em %%tagname%%...%%. Configure o comando usando o formato neste exemplo: Write-Host %%tagname1%% output1 line 1 output1 line 2 ... Write-Host%% Write-Host %%tagname2%% output2 line 1 output2 line 2 ... Write-Host%% Os marcadores retornados são objetos de hashmap JavaScript em que cada chave é prefixada com tag anexada ao tagname. {"__text__": "", "tagtagname1":"output1 line1\noutput1 line2\n", "tagtagname2":"output2 line1\noutput2 line2\n"} |
| Hresult | hresult | Cadeia de caracteres | Contém qualquer hresult retornado do comando do PowerShell. Se nenhum hresult for retornado, este parâmetro será nulo. |
| Saída | saída | Cadeia de caracteres | Contém a saída bruta do comando do PowerShell. |
| EccSysID | eccSysID | Cadeia de caracteres | Contém o ID de referência associado à mensagem de entrada da Fila do ECC retornada pela atividade. |
| ErrorMessages | errorMessages | Cadeia de caracteres | Contém qualquer mensagem de erro retornada do comando do PowerShell. Este valor será nulo se não houver mensagens de erro. |
[Tabela 2. Parâmetros de pós-processamento do PowerShell]

{#powershell-payload-parsing-tags__table_grr_t2v_cr}