> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/unmanaged_hosts/create_windows.md).

# Microsoft Windows

## Requisitos

* Linux Control Center = 2.10.X ou superior.<br>
* Credenciais de Acesso ao Host Windows com permissões necessárias.<br>
* WinRM Habilitado no Host Windows.<br>

## Overview

A funcionalidade **Unmanaged Hosts** do Linux Control Center permite a execução de Scripts em Hosts Microsoft Windows por meio do WinRM (Windows Remote Management) em Hosts que não estão sendo gerenciados pelo LCC.

Essa funcionalidade utilizar Credenciais Windows, Unmanaged Hosts e Unmanaged Grupos de Hosts registrados na Console. O LCC oferece um histórico de execuções através de Logs simplificados.

* Fluxo de configuração para executar Script em um Unmanaged Host Microsoft Windows.

1. [Cadastro do Unmanaged Host Windows](#cadastro-de-unmanaged-host-windows)
2. [Cadastro da Credencial Windows](#cadastro-de-credencial-windows)
3. [Cadastro do Script PowerShell](#cadastro-de-script-powershell)
4. [Execução de Script com o Workflow](#execucao-de-script-powershell-em-unmanaged-hosts-windows)

## Objetivo

Este documento tem como objetivo demonstrar o passo a passo de como cadastrar um *Unmanaged Host*, *Unmanaged Windows Credentials* e *Script PowerShell* para executar a Action *Custom Scripts Quick Windows*.

### Cadastro de Unmanaged Host Windows

1. Acesse o LCC e clique em **Unmanaged Hosts**.

   ![](/files/APkHnzXGAsJ1zWxE8Rdu)
2. Clique em **Unmanaged Inventory**.

   ![](/files/BZa6Ndj8rTL8TpL67SPt)
3. Clique em **Create** e preencha os seguintes campos;

   ![](/files/Gvi6fRSiRiRlyjIe975V)

   **Name**: Nome de identificar do Host.\
   **Host Type**: Selecione a opçao *Windows*.\
   **Address**: Insira o endereço IP do Host Windows com pontos Ex: 192.168.0.25\
   **Port**: Insira a porta do WinRM do Host<br>
4. Clique em **Save**.

   ![](/files/vMOgA44gIwWyWwKZridz)

### Cadastro de Credencial Windows

* Esta credencial será responsável por acessar o Host e executar o *Script* desejado.

1. Acesse a tela **Unmanaged Hosts**.

   ![](/files/APkHnzXGAsJ1zWxE8Rdu)
2. Clique em **Host Credentials**.

   ![](/files/UmSSDWjUmjDgG8Nufrrj)
3. Clique em **Windows Credentials**.

   ![](/files/UFeSHoXbC73K5VGwql14)
4. Clique em **Create**.

   ![](/files/t2cragSIeOomljgRUPdd)
5. Preencha os campos solicitados e clique em **Save**.

   **Name**: Nome para identificar a credencial\
   **Username**: Usuário para executar o Script\
   **Password**: Senha do usuário para executar o Script<br>

   ![](/files/592RM9N0GthbCC7zb0tp)

### Cadastro de Script PowerShell

1. Acesse a tela **Unmanaged Hosts**.

   ![](/files/APkHnzXGAsJ1zWxE8Rdu)
2. Clique em **Scripts**.

* Esta tela é a mesma tela Hosts do menu lateral esquerdo, onde ficam todos os scripts cadastrados no LCC, tanto para Windows quanto para Linux.

1. Clique em **Create**.

   ![](/files/hDYenFn7J8OvMQppHf7L)
2. Preencha os seguintes campos;

   **Name**: Nome para identificar o Script.\
   **Host Type**: Selecione a opção *Windows*.<br>

   ![](/files/w5eTRk8Fek55FEwbFrNo)
3. Clique em **Upload File** e faça upload do Script Windows.

   ![](/files/mwEEyjZXwI6OElmgDatL)
4. Clique em **Save**.

   ![](/files/bw42HuawJcmguiVRjwvJ)

### Execução de Script PowerShell em Unmanaged Hosts Windows

1. Clique em **Workflow** no meu lateral esquerdo.

   ![](/files/e12Z2zvyI4vvBkZQNMpa)
2. Clique em **Create**.

   ![](/files/NAAcXSUEUFsKy20cUNuE)
3. Insira o nome para o Workflow no campo **Name**.

   ![](/files/xE33RJXnSSPEkQTyE4PJ)
4. Clique em **Start New Workflow**.

   ![](/files/sljxjxCkcV80jZokLW1w)
5. Escolha a *Ação* **Custom Script Quick Windows** no campo *Action*.

   ![](/files/Sm3IBikfNvyVWFmPav8q)
6. Preencha os campos conforme orientação abaixo;

   * **Script**: Escolha o Script PowerShell que será executado.<br>
   * **Unmanaged Host**: Escolha o Unmanaged Host Windows em que o Script será executado.<br>
   * Também é possível executar o Script em um *Unmanaged Group*.

   ![](/files/hQ6Q6iCD38dN8xtjcnpa)
7. Clique em **Create**.

   ![](/files/H67Rs0rIFdTjNOIc1MqO)
8. Clique em **Save**

   ![](/files/rq5iO2Zg2Ayxwue5rpWB)
9. Clique em **Actions** do *Workflow* criado e clique em **Run**.

   ![](/files/tj3clAYFu0RtmhFMRPW6)
10. Clique em **Agree** para executar o *Workflow*.

    ![](/files/pHUOA1I4Ib3mbkcGlbHI)
