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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linuxcontrolcenter.com.br/unmanaged_hosts/create_windows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
