> 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/en/unmanaged-hosts/unmanaged-windows.md).
# Microsoft Windows
## Requirements
* Linux Control Center = 2.10.X or higher.
* Access Credentials to the Windows Host with the necessary permissions.
* WinRM Enabled on the Windows Host.
## Overview
The Linux Control Center **Unmanaged Hosts** functionality allows the execution of Scripts on Microsoft Windows Hosts through WinRM (Windows Remote Management) on Hosts that are not being managed by the LCC.
This functionality uses Windows Credentials, Unmanaged Hosts and Unmanaged Host Groups registered in the Console. The LCC offers a history of executions through simplified Logs.
* Configuration flow to execute Scripts on an Unmanaged Microsoft Windows Host.
1. [Unmanaged Host Windows Registration](#unmanaged-host-windows-registration)
2. [Windows Credential Registration](#windows-credential-registration)
3. [PowerShell Script Registration](#powershell-script-registration)
4. [Script Execution with Workflow](#executing-a-powershell-script-on-unmanaged-windows-hosts)
## Objective
This document aims to demonstrate step by step how to register an *Unmanaged Host*, *Unmanaged Windows Credentials* and *PowerShell Script* to execute the *Custom Scripts Quick Windows* Action.
### Unmanaged Host Windows Registration
1. Access the LCC and click on **Unmanaged Hosts**.
2. Click **Unmanaged Inventory**.
3. Click **Create** and fill in the following fields;
**Name**: Name to identify the Host.\
**Host Type**: Select the *Windows* option.\
**Address**: Enter the Windows Host IP address with dots. Ex: 192.168.0.25\
**Port**: Enter the Host's WinRM port
1. Click **Save**.
### Windows Credential Registration
* This credential will be responsible for accessing the Host and executing the desired *Script*.
1. Access the **Unmanaged Hosts** screen.
2. Click **Host Credentials**.
3. Click **Windows Credentials**.
4. Click **Create**.
5. Fill in the requested fields and click **Save**.
**Name**: Name to identify the credential\
**Username**: User to run the Script\
**Password**: User password to run the Script
```
```
### PowerShell Script Registration
1. Access the **Unmanaged Hosts** screen.
2. Click on **Scripts**.
* This screen is the same as the Hosts screen on the left side menu, where all the scripts registered in LCC are located, both for Windows and Linux.
1. Click on **Create**.
2. Fill in the following fields;
**Name**: Name to identify the Script.\
**Host Type**: Select the *Windows* option.
```
```
1. Click on **Upload File** and upload the Windows Script.
2. Click on **Save**.
### Executing a PowerShell Script on Unmanaged Windows Hosts
1. Click on **Workflow** on the left sidebar.
2. Click **Create**.
3. Enter a name for the Workflow in the **Name** field.
4. Click **Start New Workflow**.
5. Choose the **Custom Script Quick Windows** *Action* in the *Action* field.
6. Fill in the fields as instructed below;
* **Script**: Choose the PowerShell Script that will be executed.
* **Unmanaged Host**: Choose the Unmanaged Host Windows on which the Script will be executed.
* It is also possible to execute the Script in an *Unmanaged Group*.
1. Click **Create**.
2. Click **Save**
3. Click **Actions** of the *Workflow* you created and click **Run**.
4. Click **Agree** to run the *Workflow*.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.linuxcontrolcenter.com.br/en/unmanaged-hosts/unmanaged-windows.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.