To install the module manually we will at first fetch information on where we can actually install the module into. PowerShell provides some default directories, which can however also extended manually.
Getting Started
---
To do this, we can run the following command within PowerShell
```powershell
echo $env:PSModulePath
```
***We do recommend to use the Program Files folder (in case it's present) to install the module into, which will make the installation as service easier***
To be able to use the module, you will require to have named the folder **exactly** as the .psm1 and .psd1 files inside the repository.
If you receive an output stating that the module is installed, you are fine to continue.
Execution Policies and File Blocking
---
In order to be able to run the module on certain Windows Hosts, it might be required to either update the execution policies and/or unblock the module script files.
The prefered way is to simply unblock the script files, allowing them to be executed on the system. This can be done by running a PowerShell instance as **Administrator** and enter the following command (we assume the module is installed at `C:\Program Files\WindowsPowershell\Modules\icinga-powershell-framework`. If not, please modify the command with the correct location)
Once done, please try again if you are now able to run the module on your host. If you are still not able to run the module and/or its scripts, please have a look at the Microsoft documentation for the [Set-Execution-Policy](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-6) Cmdlet to modify the Execution Policy for running PowerShell modules on your host, matching your internal guidelines.
Once the entire Framework is installed and the module is runnable, you can start the installation wizard of the Agent:
```powershell
Use-Icinga;
Start-IcingaAgentInstallWizard;
```
The wizard will then guide you through the entire configuration and installation. Once completed, you will receive a configuration string with all your configured settings to easily run the same command on another machine or for automated installation.
