---
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


---

# Atividades do PowerShell

# Atividades do 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

O PowerShell foi criado no Windows .NET Framework e foi projetado para controlar e automatizar a administração de máquinas e aplicações Windows.

O PowerShell deve ser instalado em qualquer MID Server que use essas atividades. Os MID Servers que usam o PowerShell devem ser instalados em um sistema operacional compatível com Windows. ServiceNow é compatível com o PowerShell 3.0 ao 5.1.{#c_OrchestrPowerShellActivities__ph_Supported_PowerShell_Versions}

O plug-in ServiceNow [Orquestração](https://servicenow-prod.fluidtopics.net/74KCYAb0ISob01STbnCTAw "Use Orquestração atividades em um Fluxo de trabalho para integrar com sistemas de terceiros.") adiciona essas atividades básicas do PowerShell aos fluxos de trabalho. Para obter instruções sobre como usar atividades do pacote de atividades do PowerShell, consulte [Pacote de atividade do PowerShell](https://servicenow-prod.fluidtopics.net/vSDT1QAo34MpSix2T1BUzg "O PowerShell foi criado no Windows .NET Framework e foi projetado para controlar e automatizar a administração de máquinas e aplicações Windows.")

## Atividade de Execução de Legado do PowerShell {#ariaid-title2}

A atividade Executar PowerShell executa comandos do PowerShell do Windows em um MID Server.
Importante:  
Esta atividade foi descontinuada e não está disponível para novos fluxos de trabalho. Para substituir a funcionalidade desta atividade, use o [modelo de atividade do Powershell](https://servicenow-prod.fluidtopics.net/Ar2KgjX9yZB1xQDKNXQuVw#t_CreateAPowershellActivity "Crie uma atividade PowerShell personalizada para retornar dados a um fluxo de trabalho a partir de um host usando o Microsoft PowerShell.") para criar uma atividade com escopo personalizado. Fluxos de trabalho de uma versão anterior que usam a atividade Run PowerShell podem continuar a fazer isso.

### Valores de resultado

O designer de fluxo de trabalho pode atribuir um valor de resultado usando activity.result de dentro de um campo de script da atividade. Por padrão, o sucesso ou a falha dos comandos do PowerShell usados determina o valor do resultado da atividade Executar PowerShell. Os valores de resultado possíveis são:

* Êxito
* Falha
{#r_RunPowershellActivity__ul_oqc_yxs_hp}

### Entradas do Bloco de anotações

As informações gravadas em <var class="keyword varname">stdout</var> pelo script em execução são capturadas e retornadas para a atividade na variável<var class="keyword varname"> activity.output</var>. Essas informações podem ser analisadas, processadas ou salvas (em uma variável do bloco de anotações, por exemplo) para processamento futuro no script do sensor da atividade.  
Um exemplo seria executar o comando get-date para obter a hora atual do MID Server. Este script de sensor salva a saída completa recebida, mas podemos processá-la para retornar e salvar somente o tempo.Figura 1. Atividade PowerShell  
Nota:  
Este é um exemplo simplificado demais. Na maioria dos casos, o script opera em algum computador remoto Windows. No entanto, o principal é o mesmo - tudo o que é gravado em `stdout` é retornado em `activity.output` e fica disponível para processamento.

### Variáveis de entrada

{#r_RunPowershellActivity__table_kh2_mys_hp__entry__2}

| Campo | Descrição |
|-|-|
| Nome do host | Endereço IP da máquina Windows de destino. Este valor é mapeado para a variável <var class="keyword varname">$computer</var> para uso em comandos (consulte o exemplo no campo Comando ). Uma variável de credencial do PowerShell chamada <var class="keyword varname">$cred</var> que se baseia nas informações da tabela ServiceNow Credenciais será autenticada no computador apontado por Hostname. |
| Comando | Insira o comando do PowerShell a ser executado. Por exemplo, para executar uma consulta de WMI simples em uma máquina remota apontada pela variável <var class="keyword varname">hostname</var>, o comando é: get-wmiobject <class> -computer $computer -credential $cred Se nenhuma credencial for autenticada no computador, o comando será executado no contexto do usuário do MID Server. Você não pode executar um comando e um arquivo de script. Especificar um comando oculta a variável do <var class="keyword varname">arquivo de script</var>. |
| Script do sensor | O script a ser executado usando os resultados da probe. A saída da probe está contida em uma variável chamada <var class="keyword varname">saída</var>. Qualquer erro do probe está contido em uma variável chamada <var class="keyword varname">erro</var>. |
| Arquivo de script | O [Habilite a sincronização de arquivo de script para Windows segurança aprimorada](https://servicenow-prod.fluidtopics.net/khWtsolBdI7375rzraqetw#c_EnableScriptFileSyncWinESecure "Windows A segurança aprimorada do Internet Explorer bloqueia arquivos baixados que ele determina que são potencialmente perigosos."). Você não pode executar um arquivo de script e um comando ao mesmo tempo. A seleção de um arquivo de script oculta a variável <var class="keyword varname">Command</var>. |
| Variáveis de script do PowerShell | Parâmetros adicionais, no formato JSON, usados pelo arquivo de script especificado. |
[Tabela 1. Variáveis de entrada]

{#r_RunPowershellActivity__table_kh2_mys_hp}

### Estados

O estado da atividade diz ao mecanismo de fluxo de trabalho o que fazer com a atividade.{#r_RunPowershellActivity__table_zvx_mzs_hp__entry__2}

| Estado | Descrição |
|-|-|
| Executando | O mecanismo de fluxo de trabalho sabe iniciar a função onExecute da atividade. |
| Terminado | A execução da atividade foi concluída. Veja o valor do resultado para o resultado da atividade. |
| Cancelado | Esta atividade ou o fluxo de trabalho que contém esta atividade foi cancelado. |
[Tabela 2. Estados]

{#r_RunPowershellActivity__table_zvx_mzs_hp}  
Adicione variáveis de fluxo de trabalho para a linha de comando usando a sintaxe de variável de fluxo de trabalho normal. No exemplo acima, se \<class\> estava em uma variável de entrada de fluxo de trabalho chamada <var class="keyword varname">myclass</var>, o comando seria semelhante a:

    get-wmiobject $ {workflow. inputs. myclass } -computer $computer --credential $cred
    Similarly  if the variable  is a scratchpad variable named myclass , the command would look like :
    get -wmiobject $ {workflow. scratchpad. myclass } -computer $computer --credential $cred

## Códigos HResult {#ariaid-title3}

Quando um script do PowerShell encontra um erro, a máquina do Windows pode retornar um código de HResult como parte da mensagem de erro.

As atividades do PowerShell podem ler e interpretar este código. Nem todos os erros do PowerShell incluem um código HResult. Em caso de falha no script do PowerShell, você pode usar o código HResult para mover o fluxo de trabalho por meio de uma condição específica.

Por exemplo, ao redefinir uma senha do Active Directory para uma senha que não atende aos requisitos de política, como tamanho mínimo ou complexidade, o script do PowerShell retorna o código HResult -2146022651. Para usar este código, crie uma condição de atividade com o valor de condição<var class="keyword varname">activity.hresult = -2146022651</var>. Se o script do PowerShell retornar este código quando a atividade for executada, o fluxo de trabalho passará por essa nova condição.