# 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**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-52ecdda62a02517f789a5ffe434f65a9cf58af91%2Fbotao_unmanaged_hosts_dashboard.png?alt=media)
2. Clique em **Unmanaged Inventory**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a2ec79058accde1068d23207cc8511691af7ee42%2Fbotao_unmanaged_inventory.png?alt=media)
3. Clique em **Create** e preencha os seguintes campos;

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-9d756fbcdd60b82cc5385f4e5f98260c9ff23fdd%2Fbotao_create_unmanaged_host.png?alt=media)

   **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**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-fc05a002af280511b946454d9f704d43e42ca5ad%2Fbotao_save_unmanaged_host.png?alt=media)

### Cadastro de Credencial Windows

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

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

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-52ecdda62a02517f789a5ffe434f65a9cf58af91%2Fbotao_unmanaged_hosts_dashboard.png?alt=media)
2. Clique em **Host Credentials**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-15029dbf13441d53f31a8800051fccca22842474%2Fbotao_hosts_credentials.png?alt=media)
3. Clique em **Windows Credentials**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-1734297e1e41d34f8586c3925f47c9fb2119dc17%2Fbotao_windows_credentials.png?alt=media)
4. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-72c4daa530f19ffeaec6f4e2a3a8baed2f1c5c62%2Fbotao_create_unmanaged_credentials.png?alt=media)
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>

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a1357f768c2dc7c07d9d91040a83375b5a695b1b%2Fbotao_save_credential.png?alt=media)

### Cadastro de Script PowerShell

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

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-52ecdda62a02517f789a5ffe434f65a9cf58af91%2Fbotao_unmanaged_hosts_dashboard.png?alt=media)
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**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-f4580c2a230931fa62c0952f325fc144433d7b09%2Fbotao_create_script.png?alt=media)
2. Preencha os seguintes campos;

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

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-2a1d8634bc81696ebd85896d621c6562f1656436%2Fcampos_script_type_e_name.png?alt=media)
3. Clique em **Upload File** e faça upload do Script Windows.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-6fbc129cc8bb7ca93f19b61a583e37709fbc5c26%2Fscript_uploaded.png?alt=media)
4. Clique em **Save**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-108f5020ec1928ede52affee1eb528ea48ace29f%2Fbotao_save_script.png?alt=media)

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

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

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-f301dfe8ab8a954bc747fe46be1a9c99c65a5d78%2Fworkflow_dashboard.png?alt=media)
2. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-7dc013a82c79b272a620e40863eb88613c3e143e%2Fbotao_create.png?alt=media)
3. Insira o nome para o Workflow no campo **Name**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-0c85429a0c02587b7b7b0c8b77e38a5a276291d5%2Fcampo_name_workflow.png?alt=media)
4. Clique em **Start New Workflow**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a76a256c531e3dd82747715ba3f703fd06c73b81%2Fbotao_start_new_workflow.png?alt=media)
5. Escolha a *Ação* **Custom Script Quick Windows** no campo *Action*.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-35e852755a80cd7eea6104501ff982e66407aab5%2Facao_quick_windows.png?alt=media)
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*.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-fc350d521107b9ca09b052655cf68ce2bcdf8d3d%2Fcampos_workflow_preenchido.png?alt=media)
7. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-d4d89d0d9873f85cf87cd643ec233038aff41fa7%2Fbotao_create_workflow.png?alt=media)
8. Clique em **Save**

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8be0968d32518d9a2be287dca56afbe30f68fca2%2Fbotao_save_workflow.png?alt=media)
9. Clique em **Actions** do *Workflow* criado e clique em **Run**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-376c5d0b9fdefa0b574d1e236021bb4c233d48ed%2Frun_workflow.png?alt=media)
10. Clique em **Agree** para executar o *Workflow*.

    ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a1eedeeee24e2b416cd8092367bbe4266c763668%2Fagree_run_workflow.png?alt=media)