Comando Powershell
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)
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 |