Powershell Command
Resumo
- Executar comandos do PowerShell por meio de um cliente PSRP (PowerShell Remoting Protocol).
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
server | string | | O nome do host ou endereço IP do host ao qual se conectar. |
port | int | 5985 | Porta para se conectar, o padrão é 5985. Para usar SSL, use a porta 5986, senão 5985. |
ssl | bool | false | Se deve se conectar por https ou https. |
username | str | | O nome de usuário com o qual se conectar, necessário para todas as autorizações, exceto certificado e opcionalmente necessário para negociar/kerberos. |
password | str | | A senha para o nome de usuário. |
command | str | | Comando a ser executado. |
reconnection_retries | int | 0 | Número de tentativas em um problema de conexão. |
connection_timeout | int | 30 | O tempo limite para criar uma conexão HTTP. |
read_timeout | int | 30 | O tempo limite para receber uma resposta do servidor depois que uma solicitação foi feita. |
show_errors | bool | true | Retorna linhas de erro se existir. |
show_warnings | bool | true | Retorna linhas de aviso, se existirem. |
Notes
- 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-JsonValores retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
output | string | Sucesso | Saída do comando executado. |
had_errors | bool | Sucesso | Informa se o comando executado retornou erros. |
output_errors | list | Sucesso | Lista de strings contendo os erros ocorridos. |
output_warnings | list | Sucesso | Lista de strings contendo os warnings ocorridos. |