---
title: Comando Powershell
slug: aiops-documentacao-tecnica/comando-powershell
docTags:
createdAt: 2024-07-18T19:19:25.812Z
---
## Resumo
- Executar o comando powershell por meio de um cliente PSRP (PowerShell Remoting Protocol)
## Paramêtros
| **Paramêtros** | **Tipo** | **Escolhas \| **
**Valor Padrão** | **Comentários** |
| -------------------------- | -------- | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| servidor | corda | | O nome do host ou endereço IP do ho ao qual se conectar |
| porta | inteiro | 5985 | Porta para se conectar, o padrão é 59 |
| SSL-SSL... | bool | falso | Você deve se conectar por http ou http |
| nome do usuário | str | | O nome do usuário para se conectar, é necessário para todas as autorizaões, exceto certificado e opcionalmente necessário para negociação/kerberos |
| senha | str | | Uma senha para o nome do usuário |
| comando | str | 0 | Comando a ser executado |
| reconexão\_tentativas | inteiro | 30 | Número de tentativas de um problema de execução |
| tempo\_limite\_de\_conexão | inteiro | 30 | O tempo limite de uma conexão HTTP |
| tempo de ler esgotado | inteiro | verdadeiro | O tempo limite para receber uma resposta do servidor depois que uma solicitação foi feita |
| mostrar\_erros
| bool | verdadeiro | As linhas de erros retornam se existirem |
| mostrar\_avisos | bool | | Retorna linha de avisos se existirem |
## Notas
- As instruçoes para habilitar o PSRP do lado do Windows podem ser vistas em [Habilitando o WinRM para PSRP (PowerShell Remoting Protocol)](docId\:EIjRozXpEDl_6RPO99TrC)
## Exemplos
\# Exemplo: Roda um comando de echo e força um erro para o output.
powershell\_command:
server: 127.0.0.1
username: user\@Domain
password: pssw123
command: |
echo ("Hey, i'm echoing!")
Write-Warning "This is only a test warning."
throw "This is an error."
\# Exemplo: Roda um programa python.
powershell\_command:
server: 127.0.0.1
username: user
password: pssw123
command: |
Set-Location -Path C:\\\Users\\\65a\\\Downloads;
.\\\python\\\python.exe main.py --sentence "Sentence passed by args." -n 5
\# Exemplo: Cria um arquivo em uma pasta, escreve um conteúdo.
powershell\_command:
server: 127.0.0.1
username: user\@Domain
password: pssw123
command: |
Set-Location -Path C:\\\Users\\\65a\\\Downloads;
New-Item test.txt;
Set-Content test.txt 'Some content for the file';
get-Content test.txt;
\# Exemplo: Cria um arquivo em uma pasta de rede.
powershell\_command:
server: 127.0.0.1
username: user
password: pssw123
command: |
New-Item -Path "\\\\\srv-br-001\\\Users\\\Public\\\FOLDER1" -ItemType Directory
\# Exemplo: Lista em json as políticas de execução.
powershell\_command:
server: 127.0.0.1
username: user
password: pssw123
ssl: false
command: |
Get-Execution Policy -List | ConvertTo-Json
## Valores devolvidos
| **Chave ** | **Tipo** | **Retornando quando** | **Descrição** |
| ----------------- | -------- | --------------------- | --------------------------------------------- |
| saída | corda | Sucesso | Saída do comendo executado |
| teve\_erros | bool | Sucesso | Informa se o comando executado retornou erros |
| erros\_de\_saía | lista | Sucesso | Lista de strings contendo os erros ocorridos |
| avisos\_de\_saída | lista | Sucesso | Lista de strings contendo os avisos ocorridos |